options = WPSEO_Options::get_option( 'wpseo_social' ); self::translate_meta_boxes(); add_filter( 'wpseo_save_metaboxes', array( $this, 'save_meta_boxes' ), 10, 1 ); add_action( 'wpseo_save_compare_data', array( $this, 'og_data_compare' ), 10, 1 ); } /** * Translate text strings for use in the meta box * * IMPORTANT: if you want to add a new string (option) somewhere, make sure you add that array key to * the main meta box definition array in the class WPSEO_Meta() as well!!!! */ public static function translate_meta_boxes() { /* translators: %s expands to the social network's name */ $title_text = __( 'If you don\'t want to use the post title for sharing the post on %s but instead want another title there, write it here.', 'wordpress-seo' ); /* translators: %s expands to the social network's name */ $description_text = __( 'If you don\'t want to use the meta description for sharing the post on %s but want another description there, write it here.', 'wordpress-seo' ); /* translators: %s expands to the social network's name */ $image_text = __( 'If you want to override the image used on %s for this post, upload / choose an image or add the URL here.', 'wordpress-seo' ); /* translators: %1$s expands to the social network, %2$s to the recommended image size */ $image_size_text = __( 'The recommended image size for %1$s is %2$spx.', 'wordpress-seo' ); $options = WPSEO_Options::get_option( 'wpseo_social' ); $social_networks = array( 'opengraph' => __( 'Facebook', 'wordpress-seo' ), 'twitter' => __( 'Twitter', 'wordpress-seo' ), ); // Source: https://blog.bufferapp.com/ideal-image-sizes-social-media-posts. $recommended_image_sizes = array( 'opengraph' => '1200 × 630', // Source: https://developers.facebook.com/docs/sharing/best-practices#images. 'twitter' => '1024 × 512', ); foreach ( $social_networks as $network => $label ) { if ( true === $options[ $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 ); self::$meta_fields['social'][ $network . '-description' ]['title'] = sprintf( __( '%s Description', 'wordpress-seo' ), $label ); self::$meta_fields['social'][ $network . '-description' ]['description'] = sprintf( $description_text, $label ); 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' ); if ( $this->options['opengraph'] === true ) { $tabs[] = new WPSEO_Metabox_Form_Tab( 'facebook', $this->get_social_tab_content( 'opengraph', $social_meta_fields ), '', array( 'link_title' => __( 'Facebook / Open Graph metadata', 'wordpress-seo' ), ) ); } if ( $this->options['twitter'] === true ) { $tabs[] = new WPSEO_Metabox_Form_Tab( 'twitter', $this->get_social_tab_content( 'twitter', $social_meta_fields ), '', array( 'link_title' => __( 'Twitter metadata', 'wordpress-seo' ), ) ); } return new WPSEO_Metabox_Tab_Section( 'social', '', $tabs, array( 'link_title' => __( 'Social', 'wordpress-seo' ), ) ); } /** * Generates the html for a social settings tab for one of the supported social media. * * @param string $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', ); $tab_content = ''; foreach ( $field_names as $field_name ) { $tab_content .= $this->do_meta_box( $meta_field_defs[ $field_name ], $field_name ); } return $tab_content; } /** * 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. if ( ! empty( $_POST ) && ! empty( $post->ID ) && $post->post_status == 'publish' && isset( $_POST['original_post_status'] ) && $_POST['original_post_status'] === 'publish' ) { $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' ); } } } /********************** DEPRECATED METHODS **********************/ /** * Define the meta boxes for the Social tab * * @deprecated 1.5.0 * @deprecated use WPSEO_Meta::get_meta_field_defs() * @see WPSEO_Meta::get_meta_field_defs() * * @param string $post_type Optional post type string. * * @return array Array containing the meta boxes */ public function get_meta_boxes( $post_type = 'post' ) { _deprecated_function( __METHOD__, 'WPSEO 1.5.0', 'WPSEO_Meta::get_meta_field_defs()' ); return $this->get_meta_field_defs( 'social' ); } /** * @deprecated 3.0 Removed. * * @return string */ public function tab_header() { _deprecated_function( 'WPSEO_Social_Admin::tab_header', 'WPSEO 3.0' ); return ''; } /** * @deprecated 3.0 Removed. * * @return string */ public function tab_content() { _deprecated_function( 'WPSEO_Social_Admin::tab_content', 'WPSEO 3.0' ); return ''; } } /* End of class */