%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* @package The_SEO_Framework\Views\Admin\Metaboxes
* @subpackage The_SEO_Framework\Admin\Settings
*/
// phpcs:disable, VariableAnalysis.CodeAnalysis.VariableAnalysis.UndefinedVariable -- includes.
// phpcs:disable, WordPress.WP.GlobalVariablesOverride -- This isn't the global scope.
use The_SEO_Framework\Bridges\SeoSettings,
The_SEO_Framework\Interpreters\HTML,
The_SEO_Framework\Interpreters\Form,
The_SEO_Framework\Interpreters\Settings_Input as Input;
defined( 'THE_SEO_FRAMEWORK_PRESENT' ) and tsf()->_verify_include_secret( $_secret ) or die;
switch ( $this->get_view_instance( 'social', $instance ) ) :
case 'social_main':
$_settings_class = SeoSettings::class;
$tabs = [
'general' => [
'name' => __( 'General', 'autodescription' ),
'callback' => [ $_settings_class, '_social_metabox_general_tab' ],
'dashicon' => 'admin-generic',
],
'facebook' => [
'name' => 'Facebook',
'callback' => [ $_settings_class, '_social_metabox_facebook_tab' ],
'dashicon' => 'facebook-alt',
],
'twitter' => [
'name' => 'Twitter',
'callback' => [ $_settings_class, '_social_metabox_twitter_tab' ],
'dashicon' => 'twitter',
],
'oembed' => [
'name' => 'oEmbed',
'callback' => [ $_settings_class, '_social_metabox_oembed_tab' ],
'dashicon' => 'share-alt2',
],
'postdates' => [
'name' => __( 'Post Dates', 'autodescription' ),
'callback' => [ $_settings_class, '_social_metabox_postdates_tab' ],
'dashicon' => 'backup',
],
];
SeoSettings::_nav_tab_wrapper(
'social',
/**
* @since 2.2.2
* @param array $defaults The default tabs.
*/
(array) apply_filters( 'the_seo_framework_social_settings_tabs', $tabs )
);
break;
case 'social_general_tab':
HTML::header_title( __( 'Social Meta Tags Settings', 'autodescription' ) );
HTML::description( __( 'Output various meta tags for social site integration, among other third-party services.', 'autodescription' ) );
?>
<hr>
<?php
// Echo Open Graph Tags checkboxes.
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'og_tags',
'label' => __( 'Output Open Graph meta tags?', 'autodescription' ),
'description' => __( 'Facebook, Twitter, Pinterest and many other social sites make use of these meta tags.', 'autodescription' ),
] ),
true
);
if ( $this->detect_og_plugin() )
HTML::attention_description( __( 'Note: Another Open Graph plugin has been detected. These meta tags might conflict.', 'autodescription' ) );
// Echo Facebook Tags checkbox.
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'facebook_tags',
'label' => __( 'Output Facebook meta tags?', 'autodescription' ),
'description' => __( 'Output various meta tags targeted at Facebook.', 'autodescription' ),
] ),
true
);
// Echo Twitter Tags checkboxes.
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'twitter_tags',
'label' => __( 'Output Twitter meta tags?', 'autodescription' ),
'description' => __( 'Output various meta tags targeted at Twitter.', 'autodescription' ),
] ),
true
);
if ( $this->detect_twitter_card_plugin() )
HTML::attention_description( __( 'Note: Another Twitter Card plugin has been detected. These meta tags might conflict.', 'autodescription' ) );
// Echo oEmbed scripts checkboxes.
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'oembed_scripts',
'label' => __( 'Output oEmbed scripts?', 'autodescription' ),
'description' => __( 'WordPress, Discord, Drupal, Squarespace, and many other clients can make use of these scripts.', 'autodescription' ),
] ),
true
);
?>
<hr>
<?php
HTML::header_title( __( 'Social Title Settings', 'autodescription' ) );
HTML::description( __( 'Most social sites and third-party services automatically include the website URL inside their embeds. When the site title is described well in the site URL, including it in the social title will be redundant.', 'autodescription' ) );
$info = HTML::make_info(
__( 'When you provide a custom Open Graph or Twitter title, the site title will be omitted automatically.', 'autodescription' ),
'',
false
);
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'social_title_rem_additions',
'label' => esc_html__( 'Remove site title from generated social titles?', 'autodescription' ) . " $info",
'escape' => false,
] ),
true
);
?>
<hr>
<?php
HTML::header_title( __( 'Social Image Settings', 'autodescription' ) );
HTML::description( __( 'A social image can be displayed when your website is shared. It is a great way to grab attention.', 'autodescription' ) );
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'multi_og_image',
'label' => __( 'Output multiple Open Graph image tags?', 'autodescription' ),
'description' => __( 'This enables users to select any image attached to the page shared on social networks, like Facebook.', 'autodescription' ),
] ),
true
);
?>
<p>
<label for="tsf_fb_socialimage-url">
<strong><?php esc_html_e( 'Social Image Fallback URL', 'autodescription' ); ?></strong>
<?php HTML::make_info( __( 'When no image is available from the page or term, this fallback image will be used instead.', 'autodescription' ), 'https://developers.facebook.com/docs/sharing/best-practices#images' ); ?>
</label>
</p>
<p>
<input class="large-text" type="url" name="<?php Input::field_name( 'social_image_fb_url' ); ?>" id="tsf_fb_socialimage-url" value="<?php echo esc_url( $this->get_option( 'social_image_fb_url' ) ); ?>" />
<input type="hidden" name="<?php Input::field_name( 'social_image_fb_id' ); ?>" id="tsf_fb_socialimage-id" value="<?php echo absint( $this->get_option( 'social_image_fb_id' ) ); ?>" disabled class="tsf-enable-media-if-js" />
</p>
<p class="hide-if-no-tsf-js">
<?php
// phpcs:ignore, WordPress.Security.EscapeOutput.OutputNotEscaped -- already escaped.
echo Form::get_image_uploader_form( [ 'id' => 'tsf_fb_socialimage' ] );
?>
</p>
<hr>
<?php
HTML::header_title( __( 'Theme Color Settings', 'autodescription' ) );
HTML::description( __( 'Discord styles embeds with the theme color. The theme color can also affect the tab-color in some browsers.', 'autodescription' ) );
?>
<p>
<label for="<?php Input::field_id( 'theme_color' ); ?>">
<strong><?php esc_html_e( 'Theme Color', 'autodescription' ); ?></strong>
</label>
</p>
<p>
<input type="text" name="<?php Input::field_name( 'theme_color' ); ?>" class="tsf-color-picker" id="<?php Input::field_id( 'theme_color' ); ?>" value="<?php echo esc_attr( $this->get_option( 'theme_color' ) ); ?>" data-tsf-default-color="" />
</p>
<hr>
<?php
HTML::header_title( __( 'Site Shortlink Settings', 'autodescription' ) );
HTML::description( __( 'The shortlink tag can be manually used for microblogging services like Twitter, but it has no SEO value whatsoever.', 'autodescription' ) );
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'shortlink_tag',
'label' => __( 'Output shortlink tag?', 'autodescription' ),
] ),
true
);
break;
case 'social_facebook_tab':
$fb_author = $this->get_option( 'facebook_author' );
$fb_author_placeholder = _x( 'https://www.facebook.com/YourPersonalProfile', 'Example Facebook Personal URL', 'autodescription' );
$fb_publisher = $this->get_option( 'facebook_publisher' );
$fb_publisher_placeholder = _x( 'https://www.facebook.com/YourBusinessProfile', 'Example Facebook Business URL', 'autodescription' );
$fb_appid = $this->get_option( 'facebook_appid' );
$fb_appid_placeholder = '123456789012345';
HTML::header_title( __( 'Facebook Integration Settings', 'autodescription' ) );
HTML::description( __( 'Facebook post sharing works mostly through Open Graph. However, you can also link your Business and Personal Facebook pages, among various other options.', 'autodescription' ) );
HTML::description( __( 'When these options are filled in, Facebook might link the Facebook profile to be followed and liked when your post or page is shared.', 'autodescription' ) );
?>
<hr>
<p>
<label for="<?php Input::field_id( 'facebook_appid' ); ?>">
<strong><?php esc_html_e( 'Facebook App ID', 'autodescription' ); ?></strong>
<?php
echo ' ';
HTML::make_info(
__( 'Get Facebook App ID.', 'autodescription' ),
'https://developers.facebook.com/apps'
);
?>
</label>
</p>
<p>
<input type="text" name="<?php Input::field_name( 'facebook_appid' ); ?>" class="large-text ltr" id="<?php Input::field_id( 'facebook_appid' ); ?>" placeholder="<?php echo esc_attr( $fb_appid_placeholder ); ?>" value="<?php echo esc_attr( $fb_appid ); ?>" />
</p>
<p>
<label for="<?php Input::field_id( 'facebook_publisher' ); ?>">
<strong><?php esc_html_e( 'Facebook Publisher page', 'autodescription' ); ?></strong>
<?php
echo ' ';
HTML::make_info(
__( 'Only Facebook Business Pages are accepted.', 'autodescription' ),
'https://www.facebook.com/business/pages/set-up'
);
?>
</label>
</p>
<p>
<input type="url" name="<?php Input::field_name( 'facebook_publisher' ); ?>" class="large-text" id="<?php Input::field_id( 'facebook_publisher' ); ?>" placeholder="<?php echo esc_attr( $fb_publisher_placeholder ); ?>" value="<?php echo esc_attr( $fb_publisher ); ?>" />
</p>
<p>
<label for="<?php Input::field_id( 'facebook_author' ); ?>">
<strong><?php esc_html_e( 'Facebook Author Fallback Page', 'autodescription' ); ?></strong>
<?php
echo ' ';
HTML::make_info(
__( 'Your Facebook profile.', 'autodescription' ),
'https://facebook.com/me'
);
?>
</label>
</p>
<?php HTML::description( __( 'Authors can override this option on their profile page.', 'autodescription' ) ); ?>
<p>
<input type="url" name="<?php Input::field_name( 'facebook_author' ); ?>" class="large-text" id="<?php Input::field_id( 'facebook_author' ); ?>" placeholder="<?php echo esc_attr( $fb_author_placeholder ); ?>" value="<?php echo esc_attr( $fb_author ); ?>" />
</p>
<?php
break;
case 'social_twitter_tab':
$tw_site = $this->get_option( 'twitter_site' );
$tw_site_placeholder = _x( '@your-site-username', 'Twitter @username', 'autodescription' );
$tw_creator = $this->get_option( 'twitter_creator' );
$tw_creator_placeholder = _x( '@your-personal-username', 'Twitter @username', 'autodescription' );
$twitter_card = $this->get_twitter_card_types();
HTML::header_title( __( 'Twitter Integration Settings', 'autodescription' ) );
HTML::description( __( 'Twitter post sharing works mostly through Twitter Cards, and may fall back to use Open Graph. However, you can also link your Business and Personal Twitter pages, among various other options.', 'autodescription' ) );
?>
<hr>
<fieldset id="tsf-twitter-cards">
<legend><?php HTML::header_title( __( 'Twitter Card Type', 'autodescription' ) ); ?></legend>
<?php
HTML::description(
__( 'The Twitter Card type may have the image highlighted, either small at the side or large above.', 'autodescription' )
);
?>
<p class="tsf-fields">
<?php
foreach ( $twitter_card as $type => $name ) {
?>
<span class="tsf-toblock">
<input type="radio" name="<?php Input::field_name( 'twitter_card' ); ?>" id="<?php Input::field_id( "twitter_card_{$type}" ); ?>" value="<?php echo esc_attr( $type ); ?>" <?php checked( $this->get_option( 'twitter_card' ), $type ); ?> />
<label for="<?php Input::field_id( "twitter_card_{$type}" ); ?>">
<span>
<?php
echo HTML::code_wrap( $name ); // phpcs:ignore, WordPress.Security.EscapeOutput
echo ' ';
HTML::make_info(
__( 'Learn more about this card.', 'autodescription' ),
"https://dev.twitter.com/cards/types/$name"
);
?>
</span>
</label>
</span>
<?php
}
?>
</p>
</fieldset>
<hr>
<?php
HTML::header_title( __( 'Card and Content Attribution', 'autodescription' ) );
/* source: https://developer.twitter.com/en/docs/tweets/optimize-with-cards/guides/getting-started#attribution */
HTML::description( __( 'Twitter claims users will be able to follow and view the profiles of attributed accounts directly from the card when these fields are filled in.', 'autodescription' ) );
HTML::description( __( 'However, for now, these fields seem to have no discernible effect.', 'autodescription' ) );
?>
<p>
<label for="<?php Input::field_id( 'twitter_site' ); ?>" class="tsf-toblock">
<strong><?php esc_html_e( 'Website Twitter Profile', 'autodescription' ); ?></strong>
<?php
echo ' ';
HTML::make_info(
__( 'Find your @username.', 'autodescription' ),
'https://twitter.com/home'
);
?>
</label>
</p>
<p>
<input type="text" name="<?php Input::field_name( 'twitter_site' ); ?>" class="large-text ltr" id="<?php Input::field_id( 'twitter_site' ); ?>" placeholder="<?php echo esc_attr( $tw_site_placeholder ); ?>" value="<?php echo esc_attr( $tw_site ); ?>" />
</p>
<p>
<label for="<?php Input::field_id( 'twitter_creator' ); ?>" class="tsf-toblock">
<strong><?php esc_html_e( 'Twitter Author Fallback Profile', 'autodescription' ); ?></strong>
<?php
echo ' ';
HTML::make_info(
__( 'Find your @username.', 'autodescription' ),
'https://twitter.com/home'
);
?>
</label>
</p>
<?php HTML::description( __( 'Authors can override this option on their profile page.', 'autodescription' ) ); ?>
<p>
<input type="text" name="<?php Input::field_name( 'twitter_creator' ); ?>" class="large-text ltr" id="<?php Input::field_id( 'twitter_creator' ); ?>" placeholder="<?php echo esc_attr( $tw_creator_placeholder ); ?>" value="<?php echo esc_attr( $tw_creator ); ?>" />
</p>
<?php
break;
case 'social_oembed_tab':
HTML::header_title( __( 'oEmbed Settings', 'autodescription' ) );
HTML::description( __( 'Some social sharing services and clients, like WordPress, LinkedIn, and Discord, obtain the linked page information via oEmbed.', 'autodescription' ) );
?>
<hr>
<?php
// Split the wraps--the informational messages make for bad legibility otherwise.
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'oembed_use_og_title',
'label' => __( 'Use Open Graph title?', 'autodescription' ),
'description' => __( 'Check this option if you want to replace page titles with Open Graph titles in embeds.', 'autodescription' ),
] ),
true
);
$_info = HTML::make_info(
__( 'Only custom social images that are selected via the Media Library are considered.', 'autodescription' ),
'',
false
);
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'oembed_use_social_image',
'label' => esc_html__( 'Use social image?', 'autodescription' ) . " $_info",
'description' => esc_html__( "LinkedIn displays the post's featured image in embeds. Check this option if you want to replace it with the social image.", 'autodescription' ),
'escape' => false,
] ),
true
);
HTML::wrap_fields(
Input::make_checkbox( [
'id' => 'oembed_remove_author',
'label' => __( 'Remove author name?', 'autodescription' ),
'description' => __( "Discord shows the page author's name above the sharing embed. Check this option if you find this undesirable.", 'autodescription' ),
] ),
true
);
break;
case 'social_postdates_tab':
$posts_i18n = esc_html__( 'Posts', 'autodescription' );
HTML::header_title( __( 'Post Date Settings', 'autodescription' ) );
HTML::description( __( "Some social sites output the shared post's publishing and modified data in the sharing snippet.", 'autodescription' ) );
?>
<hr>
<?php
HTML::wrap_fields(
[
Input::make_checkbox( [
'id' => 'post_publish_time',
'label' => $this->convert_markdown(
/* translators: the backticks are Markdown! Preserve them as-is! */
esc_html__( 'Add `article:published_time` to posts?', 'autodescription' ),
[ 'code' ]
),
'escape' => false,
] ),
Input::make_checkbox( [
'id' => 'post_modify_time',
'label' => $this->convert_markdown(
/* translators: the backticks are Markdown! Preserve them as-is! */
esc_html__( 'Add `article:modified_time` to posts?', 'autodescription' ),
[ 'code' ]
),
'escape' => false,
] ),
],
true
);
break;
default:
break;
endswitch;
Zerion Mini Shell 1.0