__( 'Facebook', 'wordpress-seo' ),
'twitter' => __( 'Twitter', 'wordpress-seo' ),
);
// Source: https://blog.bufferapp.com/ideal-image-sizes-social-media-posts.
$recommended_image_sizes = array(
/* translators: %1$s expands to the image recommended width, %2$s to its height. */
'opengraph' => sprintf( __( '%1$s by %2$s', 'wordpress-seo' ), '1200', '630' ),
// Source: https://developers.facebook.com/docs/sharing/best-practices#images.
/* translators: %1$s expands to the image recommended width, %2$s to its height. */
'twitter' => sprintf( __( '%1$s by %2$s', 'wordpress-seo' ), '1024', '512' ),
);
foreach ( $social_networks as $network => $label ) {
if ( true === WPSEO_Options::get( $network, false ) ) {
/* translators: %s expands to the name of a social network. */
self::$meta_fields['social'][ $network . '-title' ]['title'] = sprintf( __( '%s Title', 'wordpress-seo' ), $label );
self::$meta_fields['social'][ $network . '-title' ]['description'] = sprintf( $title_text, $label );
/* translators: %s expands to the name of a social network. */
self::$meta_fields['social'][ $network . '-description' ]['title'] = sprintf( __( '%s Description', 'wordpress-seo' ), $label );
self::$meta_fields['social'][ $network . '-description' ]['description'] = sprintf( $description_text, $label );
/* translators: %s expands to the name of a social network. */
self::$meta_fields['social'][ $network . '-image' ]['title'] = sprintf( __( '%s Image', 'wordpress-seo' ), $label );
self::$meta_fields['social'][ $network . '-image' ]['description'] = sprintf( $image_text, $label ) . ' ' . sprintf( $image_size_text, $label, $recommended_image_sizes[ $network ] );
}
}
}
/**
* Returns the metabox section for the social settings.
*
* @return WPSEO_Metabox_Tab_Section
*/
public function get_meta_section() {
$tabs = array();
$social_meta_fields = $this->get_meta_field_defs( 'social' );
$single = true;
$opengraph = WPSEO_Options::get( 'opengraph' );
$twitter = WPSEO_Options::get( 'twitter' );
if ( $opengraph === true && $twitter === true ) {
$single = null;
}
if ( $opengraph === true ) {
$tabs[] = new WPSEO_Metabox_Form_Tab(
'facebook',
$this->get_social_tab_content( 'opengraph', $social_meta_fields ),
'' . __( 'Facebook / Open Graph metadata', 'wordpress-seo' ) . '',
array(
'link_aria_label' => __( 'Facebook / Open Graph metadata', 'wordpress-seo' ),
'link_class' => 'yoast-tooltip yoast-tooltip-se',
'single' => $single,
)
);
}
if ( $twitter === true ) {
$tabs[] = new WPSEO_Metabox_Form_Tab(
'twitter',
$this->get_social_tab_content( 'twitter', $social_meta_fields ),
'' . __( 'Twitter metadata', 'wordpress-seo' ) . '',
array(
'link_aria_label' => __( 'Twitter metadata', 'wordpress-seo' ),
'link_class' => 'yoast-tooltip yoast-tooltip-se',
'single' => $single,
)
);
}
return new WPSEO_Metabox_Tab_Section(
'social',
'' . __( 'Social', 'wordpress-seo' ) . '',
$tabs,
array(
'link_aria_label' => __( 'Social', 'wordpress-seo' ),
'link_class' => 'yoast-tooltip yoast-tooltip-e',
)
);
}
/**
* Generates the html for a social settings tab for one of the supported social media.
*
* @param string $medium Medium. Can be 'opengraph' or 'twitter'.
* @param array $meta_field_defs The social meta field definitions.
*
* @return string
*/
private function get_social_tab_content( $medium, $meta_field_defs ) {
$field_names = array(
$medium . '-title',
$medium . '-description',
$medium . '-image',
$medium . '-image-id',
);
$tab_content = $this->get_premium_notice( $medium );
foreach ( $field_names as $field_name ) {
$tab_content .= $this->do_meta_box( $meta_field_defs[ $field_name ], $field_name );
}
return $tab_content;
}
/**
* Returns the Upgrade to Premium notice.
*
* @param string $network The social network.
*
* @return string The notice HTML on the free version, empty string on premium.
*/
public function get_premium_notice( $network ) {
$features = new WPSEO_Features();
if ( $features->is_premium() ) {
return '';
}
$network_name = __( 'Facebook', 'wordpress-seo' );
if ( 'twitter' === $network ) {
$network_name = __( 'Twitter', 'wordpress-seo' );
}
return sprintf(
'',
sprintf(
/* translators: %1$s expands to the social network's name, %2$s to Yoast SEO Premium. */
esc_html__( 'Do you want to preview what it will look like if people share this post on %1$s? You can, with %2$s.', 'wordpress-seo' ),
esc_html( $network_name ),
'Yoast SEO Premium'
),
esc_url( WPSEO_Shortlinker::get( 'https://yoa.st/179' ) ),
sprintf(
/* translators: %s expands to Yoast SEO Premium. */
esc_html__( 'Find out why you should upgrade to %s', 'wordpress-seo' ),
'Yoast SEO Premium'
)
);
}
/**
* Filter over the meta boxes to save, this function adds the Social meta boxes.
*
* @param array $field_defs Array of metaboxes to save.
*
* @return array
*/
public function save_meta_boxes( $field_defs ) {
return array_merge( $field_defs, $this->get_meta_field_defs( 'social' ) );
}
/**
* This method will compare opengraph fields with the posted values.
*
* When fields are changed, the facebook cache will be purge.
*
* @param WP_Post $post Post instance.
*/
public function og_data_compare( $post ) {
// Check if post data is available, if post_id is set and if original post_status is publish.
// @codingStandardsIgnoreStart
if (
! empty( $_POST ) && ! empty( $post->ID ) && $post->post_status === 'publish' &&
isset( $_POST['original_post_status'] ) && $_POST['original_post_status'] === 'publish'
) {
// @codingStandardsIgnoreEnd
$fields_to_compare = array(
'opengraph-title',
'opengraph-description',
'opengraph-image',
);
$reset_facebook_cache = false;
foreach ( $fields_to_compare as $field_to_compare ) {
$old_value = self::get_value( $field_to_compare, $post->ID );
$new_value = self::get_post_value( self::$form_prefix . $field_to_compare );
if ( $old_value !== $new_value ) {
$reset_facebook_cache = true;
break;
}
}
unset( $field_to_compare, $old_value, $new_value );
if ( $reset_facebook_cache ) {
wp_remote_get(
'https://graph.facebook.com/?id=' . get_permalink( $post->ID ) . '&scrape=true&method=post'
);
}
}
}
} /* End of class */