Custom Content Types

Are you familiar with Jetpack’s Restaurant Menus Custom Post Type? It allows you to create menus for your restaurant website. You can learn more about it here.

We’ve added 3 new filters, jetpack_nova_menu_item_loop_open_element, jetpack_nova_menu_item_loop_close_element, and jetpack_nova_menu_item_loop_class. Those filters will allow you to customize the HTML structure of each Menu item to fit your needs.

Markdown

By default, Jetpack’s Markdown module doesn’t parse content inside shortcodes, to avoid breaking the output generated for a specific theme or plugin. You can now use jetpack_markdown_preserve_shortcodes to overwrite that default behaviour:

add_filter( 'jetpack_markdown_preserve_shortcodes', '__return_false' );

Protect

In some cases, you may have built your own function that verifies users. When it returns true, you know the login should not be blocked and may want to bypass Jetpack’s Protect checks. The jpp_allow_login filter will help you do just that.

function jetpackcom_let_me_in( $ip ) {
    if ( 'xxx.xx.xx.x' === $ip ) {
        return true;
    }
    return false;
}
add_filter( 'jpp_allow_login', 'jetpackcom_let_me_in', 10, 1 );

Sharing / Likes

You can use the new jetpack_sharing_headline_html filter to customize the HTML structure of the Sharing buttons headline. In the example below, we’ll change the Sharing buttons’ headline structure to use h1 instead of the default h3:

function jetpackcom_custom_heading( $headline, $label, $module ) {
        if ( 'sharing' == $module ) {
                $headline = sprintf(
                        '<h1>%s</h1>',
                        $label
                );
        }
        return $headline;
}
add_filter( 'jetpack_sharing_headline_html', 'jetpackcom_custom_heading', 10, 3 );

Tiled Galleries

The 2 new jetpack_tiled_gallery_template and jetpack_tiled_gallery_partial templates will allow you to build your own template files for Tiled Galleries, with your own custom output.

Widgets

The jetpack_top_posts_widget_permalink filter allows you to customize the links included in Jetpack’s Top Posts & Pages Widget. In the example below, we’ll add Google Analytics campaign tracking parameters to each URL:

function jetpackcom_top_posts_widget_permalink( $permalink, $post ) {
    return $permalink . '?utm_source=widget';
}
add_filter( 'jetpack_top_posts_widget_permalink', 'jetpackcom_top_posts_widget_permalink', 10, 2 );

Widget Visibility

The Widget Visibility module offers many configuration options. It also supports any custom taxonomies you may have created for your site.

If you’d like to exclude some of those taxonomies from the configuration options, you can use the jetpack_widget_visibility_tax_args filter, like so:

function jetpackcom_custom_tax_wv( $args ) {
    $args['public'] = true;
    return $args;
}
add_filter( 'jetpack_widget_visibility_tax_args', 'jetpackcom_custom_tax_wv' );

General filters

You can now use a filter to choose the authorization flow your site goes through. By default you’ll go through Calypso when connecting your site to WordPress.com, but you can also use jetpack to use the old authorization flow:

function jetpack_filter_auth_type() {
    return 'jetpack';
}
add_filter( 'jetpack_auth_type', 'jetpack_filter_auth_type' );

You can use the grunion_max_new_fields filter to change that number, like so:

function jeherve_more_contact_fields() {
    return 20;
}
add_filter( 'grunion_max_new_fields', 'jeherve_more_contact_fields' );

This can be useful on sites where folks need to create advanced forms, with multiple options.

These tags allow Social Networks like Facebook, LinkedIn, Google+, or Pinterest to gather information about a post and build a post preview. Without those tags, Social Networks like Facebook will in some cases reject a post that’s been posted via an app, like Publicize.

We also add Twitter Meta Cards tags, since Twitter requires its own set of tags.

These Social Networks do not rely on the description meta tag, though. That’s why we didn’t add it to the list of tags added by Jetpack. Since this tag is mostly useful for Search Engines, it’s often included in Search Engine Optimization plugins, like Yoast SEO. If you’re interested in adding the tag to your site, you could use this plugin.

Another alternative would be to extend Jetpack’s default list of tags, and add your own, based on the existing og:description tag. To do so, you can paste the following in your theme’s functions.php file, or in a functionality plugin:

/**
 * Add a new tag, named description, matching the existing og:description tag.
 *
 * If og:description doesn't exist for a post/page, do not add any new tag.
 *
 * @filter jetpack_open_graph_tags
 * @uses isset
 */
function jeherve_custom_desc_tag( $tags ) {
	if ( isset( $tags['og:description'] ) ) {
		$tags['description'] = $tags['og:description'];
	}
	return $tags;
}
add_filter( 'jetpack_open_graph_tags', 'jeherve_custom_desc_tag' );

/**
 * Replace property="description" by name="description" in the new tag.
 *
 * Jetpack uses property="thing" as template for its Meta tags,
 * because it's built to output OG Tags. However, we we want to output a general tag here.
 *
 * @filter jetpack_open_graph_output
 * @uses str_replace
 */
function jeherve_desc_tag_output( $og_tag ) {

	// Replace property="description" by name="description"
	$og_tag = str_replace( 'property="description"', 'name="description"', $og_tag );

	return $og_tag;
}
add_filter( 'jetpack_open_graph_output', 'jeherve_desc_tag_output' );

To completely remove the buttons, we’ll use 2 Jetpack features: the sharing_show filter, and a function named jetpack_is_mobile(). That function allows you to detect whether your reader browses your site using a mobile device (with a Mobile User Agent).

// Check if we are on mobile
function jetpackme_is_mobile() {

    // Are Jetpack Mobile functions available?
    if ( ! function_exists( 'jetpack_is_mobile' ) ) {
        return false;
    }

    // Is Mobile theme showing?
    if ( isset( $_COOKIE['akm_mobile'] ) && $_COOKIE['akm_mobile'] == 'false' ) {
        return false;
    }

    return jetpack_is_mobile();
}

// Let's remove the sharing buttons when on mobile
function jetpackme_maybe_add_filter() {

    // On mobile?
    if ( jetpackme_is_mobile() ) {
        add_filter( 'sharing_show', '__return_false' );
    }
}
add_action( 'wp_head', 'jetpackme_maybe_add_filter' );

By default, the Top Posts widget includes all popular posts on your site in the past 2 days, even if those posts were published a long time ago. The jetpack_widget_get_top_posts filter allows you to change that, and remove all Popular posts that weren’t published within the last month.

/**
 * Remove all Popular posts that weren't published within the last month
 */
function jeherve_remove_old_top_posts( $posts, $post_ids, $count ) {
    foreach ( $posts as $k => $post ) {
        // Date when the post was published
        $post_date = strtotime( get_the_date( 'Ymd', $post['post_id'] ) );

        // If the post was published more than 30 days ago, let's remove it from the Top Posts widget
        if ( $post_date < strtotime( '-30 days' ) ) {
            unset( $posts[$k] );
        }
    }
    return $posts;
}
add_filter( 'jetpack_widget_get_top_posts', 'jeherve_remove_old_top_posts', 10, 3 );

If you’d like to add support for another Custom Post Type, you can use the jetpack_sitemap_post_types filter, like so:

function jeherve_add_cpt_sitemaps( $post_types ) {
	$post_types[] = 'your_post_type';
	return $post_types;
}
add_filter( 'jetpack_sitemap_post_types', 'jeherve_add_cpt_sitemaps' );

Fore more details, see the page on how to use filters to customize Jetpack.