' . esc_html__('Choose how visitors add your site as a preferred source. You can switch anytime.', 'add-as-preferred-source') . '
';
}
/**
* Badge & Link section callback — these apply to both the banner and
* the inline button, so they live here instead of under either tab.
*/
public function shared_section_callback() {
echo '' . esc_html__('These apply wherever your badge or button appears — the banner, the inline button, or both.', 'add-as-preferred-source') . '
';
}
/**
* The languages Google's preferred-source script itself supports (its
* `data-lang` / `lang` values), independent of which 17 languages we
* happen to have bundled badge images for. Used by the "Your Own Design"
* and "Google's Own Button" language pickers, since neither renders our
* badge image and so isn't limited to that smaller list.
*/
public function get_google_publisher_languages() {
return array(
'ar' => 'Arabic',
'bg' => 'Bulgarian',
'bn' => 'Bengali',
'cs' => 'Czech',
'da' => 'Danish',
'de' => 'German',
'el' => 'Greek',
'en' => 'English',
'en-GB' => 'English (UK)',
'es' => 'Spanish',
'es-419' => 'Spanish (Latin America)',
'et' => 'Estonian',
'fil' => 'Filipino',
'fr' => 'French',
'fr-CA' => 'French (Canadian)',
'gu' => 'Gujarati',
'hi' => 'Hindi',
'hr' => 'Croatian',
'hu' => 'Hungarian',
'id' => 'Indonesian',
'it' => 'Italian',
'iw' => 'Hebrew',
'ja' => 'Japanese',
'kn' => 'Kannada',
'ko' => 'Korean',
'lt' => 'Lithuanian',
'lv' => 'Latvian',
'ml' => 'Malayalam',
'mr' => 'Marathi',
'ms' => 'Malay',
'nl' => 'Dutch',
'no' => 'Norwegian (Bokmal)',
'pa' => 'Punjabi',
'pl' => 'Polish',
'pt-BR' => 'Portuguese (Brazil)',
'pt-PT' => 'Portuguese (Portugal)',
'ro' => 'Romanian',
'ru' => 'Russian',
'sk' => 'Slovak',
'sl' => 'Slovenian',
'sv' => 'Swedish',
'ta' => 'Tamil',
'te' => 'Telugu',
'th' => 'Thai',
'tr' => 'Turkish',
'uk' => 'Ukrainian',
'ur' => 'Urdu',
'vi' => 'Vietnamese',
'zh-CN' => 'Chinese (Simplified)',
'zh-HK' => 'Chinese (Hong Kong)',
'zh-TW' => 'Chinese (Traditional)',
);
}
/**
* Renders a of Google's publisher languages plus a leading
* "auto" option, for a given field id/name/saved value.
*/
private function google_lang_select($id, $name, $saved) {
echo '';
echo '' . esc_html__("Match visitor's browser", 'add-as-preferred-source') . ' ';
foreach ($this->get_google_publisher_languages() as $code => $label) {
echo '' . esc_html($label) . ' ';
}
echo ' ';
}
/**
* Implementation method callback — renders the 3 selectable cards plus
* each method's small settings panel underneath.
*/
public function implementation_method_callback() {
$method = isset($this->options['implementation_method']) ? $this->options['implementation_method'] : 'legacy';
if (!in_array($method, array('legacy', 'advanced', 'standard'), true)) {
$method = 'legacy';
}
$standard_theme = isset($this->options['standard_theme']) ? $this->options['standard_theme'] : 'light';
$standard_lang = isset($this->options['standard_lang']) ? $this->options['standard_lang'] : 'auto';
$advanced_lang = isset($this->options['advanced_lang']) ? $this->options['advanced_lang'] : 'auto';
$cards = array(
'legacy' => array(
'tag' => __('Classic', 'add-as-preferred-source'),
'title' => __('Simple link', 'add-as-preferred-source'),
'desc' => __('Your current setup. The badge links straight to Google\'s page for adding your site — nothing else to set up.', 'add-as-preferred-source'),
),
'advanced' => array(
'tag' => __('Your design', 'add-as-preferred-source'),
'title' => __('Your own design', 'add-as-preferred-source'),
'desc' => __('Keeps your banner and badge exactly as you\'ve designed them, while connecting directly to Google behind the scenes.', 'add-as-preferred-source'),
'badge' => __('Recommended', 'add-as-preferred-source'),
),
'standard' => array(
'tag' => __('Google\'s design', 'add-as-preferred-source'),
'title' => __('Google\'s own button', 'add-as-preferred-source'),
'desc' => __('Google draws and styles the button itself. Quickest to set up, but you only choose light/dark and language — not colors, wording, or a custom layout like "Boxed".', 'add-as-preferred-source'),
),
);
echo '';
foreach ($cards as $value => $card) {
echo '';
echo '';
echo '' . esc_html($card['badge']) . ' ';
}
echo ' ';
echo '' . esc_html($card['tag']) . ' ';
echo '' . esc_html($card['title']) . ' ';
echo '' . esc_html($card['desc']) . ' ';
echo ' ';
}
echo '
';
// Panel: Simple Link — nothing to configure.
echo '';
echo '
' . esc_html__('Nothing to set up here — appearance is controlled on the Banner Settings and Inline Button tabs, same as today.', 'add-as-preferred-source') . '
';
echo '
';
echo '
';
echo '' . esc_html__("Google's dialog language", 'add-as-preferred-source') . ' ';
$this->google_lang_select('adasprso_advanced_lang', 'adasprso_options[advanced_lang]', $advanced_lang);
echo '
';
echo '
' . esc_html__('Your banner colors, badge text, and the inline button styles all still apply — set them on the Banner Settings and Inline Button tabs, same as today. This only sets the language Google itself uses for its confirmation dialog.', 'add-as-preferred-source') . '
';
echo '
';
echo '
';
echo '' . esc_html__('Button theme', 'add-as-preferred-source') . ' ';
echo '';
echo '' . esc_html__('Light', 'add-as-preferred-source') . ' ';
echo '' . esc_html__('Dark', 'add-as-preferred-source') . ' ';
echo ' ';
echo '
';
echo '
';
echo '' . esc_html__('Language', 'add-as-preferred-source') . ' ';
$this->google_lang_select('adasprso_standard_lang', 'adasprso_options[standard_lang]', $standard_lang);
echo '
';
echo '
' . esc_html__('Shown wherever you already enabled it - the "Enable Banner" toggle on the Banner Settings tab, and/or "Enable Inline Button" on the Inline Button tab. Colors, text, and badge style from those tabs won\'t apply while this is selected.', 'add-as-preferred-source') . '
';
echo '
' . esc_html__('Want your own colors, wording, or a layout like "Boxed"? Switch to "Your own design" above instead.', 'add-as-preferred-source') . '
';
echo '
' . esc_html__("Not used with Google's own button", 'add-as-preferred-source') . ' ';
}
/**
* General section callback
*
* @since 1.0.0
*/
public function general_section_callback() {
echo '' . esc_html__('Configure the general settings for your preferred source banner.', 'add-as-preferred-source') . '
';
}
/**
* Color section callback
*
* @since 1.0.0
*/
public function color_section_callback() {
echo '' . esc_html__('Customize the colors for your preferred source banner.', 'add-as-preferred-source') . '
';
}
/**
* Device section callback
*
* @since 1.0.0
*/
public function device_section_callback() {
echo '' . esc_html__('Choose on which devices the banner should be displayed.', 'add-as-preferred-source') . '
';
}
/**
* Enable callback
*
* @since 1.0.0
*/
public function enabled_callback() {
$enabled = isset($this->options['enabled']) ? $this->options['enabled'] : 0;
echo '' . esc_html__('Enable preferred source banner', 'add-as-preferred-source') . ' ';
}
/**
* Website name callback
*
* @since 1.0.0
*/
public function website_name_callback() {
$website_name = isset($this->options['website_name']) ? $this->options['website_name'] : get_bloginfo('name');
echo '' . esc_html__('Enter your website name for the banner text.', 'add-as-preferred-source') . '
';
}
/**
* Custom domain callback
*/
public function custom_domain_callback() {
$custom_domain = isset( $this->options['custom_domain'] ) ? $this->options['custom_domain'] : '';
$default_url = wp_parse_url( home_url(), PHP_URL_HOST );
echo '' . sprintf(
/* translators: %s: the site's hostname */
esc_html__( 'Currently using: %s. Enter a value to override.', 'add-as-preferred-source' ),
'' . esc_html( $default_url ) . ''
) . '
';
} else {
echo '' . esc_html__( 'Override the URL used in the Google Preferred Source link. Leave empty to use your site\'s domain automatically.', 'add-as-preferred-source' ) . '
';
}
echo '' . esc_html__( 'With "Your own design," this only affects the backup link shown if the button can\'t load — Google detects your site automatically the rest of the time. With "Google\'s own button," it has no effect at all.', 'add-as-preferred-source' ) . '
';
}
/**
* Banner text callback
*
* @since 1.0.0
*/
public function banner_text_callback() {
$banner_text = isset($this->options['banner_text']) ? $this->options['banner_text'] : 'Add as a preferred source on Google';
echo '' . esc_html__('Enter the text to display in the banner. Use {website_name} to include the website name.', 'add-as-preferred-source') . '
';
}
/**
* Banner position callback
*
* @since 1.0.0
*/
public function banner_position_callback() {
$banner_position = isset($this->options['banner_position']) ? $this->options['banner_position'] : 'bottom';
?>
>
>
options['banner_bg_color']) ? $this->options['banner_bg_color'] : '#1a1a1a';
echo '' . esc_html__('Display banner on mobile devices', 'add-as-preferred-source') . ' ';
}
/**
* Show on desktop callback
*
* @since 1.0.0
*/
public function show_on_desktop_callback() {
$show_on_desktop = isset($this->options['show_on_desktop']) ? $this->options['show_on_desktop'] : 1;
echo '' . esc_html__('Display banner on desktop devices', 'add-as-preferred-source') . ' ';
}
/**
* Inline section callback
*/
public function inline_section_callback() {
echo '' . esc_html__('Configure the inline "Add as Preferred Source" button that appears within your content.', 'add-as-preferred-source') . '
';
}
/**
* Inline style callback
*/
public function inline_style_callback() {
$style = isset( $this->options['inline_style'] ) ? $this->options['inline_style'] : 'default';
?>
>
>
>
>
>
>
standard_inactive_tag(); ?>
options['inline_enabled']) ? $this->options['inline_enabled'] : 0;
echo '' . esc_html__('Enable the inline button', 'add-as-preferred-source') . ' ';
}
/**
* Inline position callback
*/
public function inline_position_callback() {
$inline_position = isset($this->options['inline_position']) ? $this->options['inline_position'] : 'both';
?>
>
>
>
options['inline_post_types']) ? $this->options['inline_post_types'] : array('post');
// Get all public post types
$args = array(
'public' => true,
'_builtin' => false
);
$post_types = get_post_types($args, 'objects');
// Add built-in types
$post_types['post'] = get_post_type_object('post');
$post_types['page'] = get_post_type_object('page');
echo '';
foreach ($post_types as $post_file => $post_type) {
echo '';
echo ' ';
echo '' . esc_html__('Select the post types where the button should appear.', 'add-as-preferred-source') . '
';
}
/**
* Inline Background Color Callback
*/
public function inline_bg_color_callback() {
$bg_color = isset($this->options['inline_bg_color']) ? $this->options['inline_bg_color'] : '#ffffff';
echo '' . esc_html__('The main title text. For the "Link" style, this is the underlined clickable phrase.', 'add-as-preferred-source') . '
';
}
/**
* Inline subtitle callback
*/
public function inline_subtitle_callback() {
$inline_subtitle = isset($this->options['inline_subtitle']) ? $this->options['inline_subtitle'] : 'Follow us for the latest travel updates and guides.';
echo '' . esc_html__('The secondary text displayed below the title.', 'add-as-preferred-source') . '
';
}
/**
* Link style lead-in text callback (sentence before the clickable phrase)
*/
public function inline_link_prefix_callback() {
$val = isset($this->options['inline_link_prefix']) ? $this->options['inline_link_prefix'] : 'Enjoyed this article? You can';
echo '' . esc_html__('Only used by the "Link" style - the sentence shown before the clickable phrase.', 'add-as-preferred-source') . '
';
}
/**
* Link style closing text callback (sentence after the clickable phrase)
*/
public function inline_link_suffix_callback() {
$val = isset($this->options['inline_link_suffix']) ? $this->options['inline_link_suffix'] : 'to see more from us.';
echo '' . esc_html__('Only used by the "Link" style - the sentence shown after the clickable phrase.', 'add-as-preferred-source') . '
';
}
/**
* Returns the saved value for a Shortcode tab field, falling back to the
* matching Inline Button setting and then to the built-in default - the
* same chain ADASPRSO_Public::placement_value() uses, so the settings
* screen always shows what the front end will actually render.
*
* @since 1.3.0
* @param string $key Key without its prefix, e.g. 'text'.
* @param mixed $fallback Built-in default.
* @return mixed
*/
private function shortcode_default( $key, $fallback ) {
if ( isset( $this->options[ 'shortcode_' . $key ] ) ) {
return $this->options[ 'shortcode_' . $key ];
}
if ( isset( $this->options[ 'inline_' . $key ] ) ) {
return $this->options[ 'inline_' . $key ];
}
return $fallback;
}
/**
* Shortcode section callback
*/
public function shortcode_section_callback() {
echo '' . esc_html__( 'These settings control the button when you place it yourself - with the shortcode, the editor block, or the template tag. They are separate from the Inline Button tab, so you can turn automatic insertion off and still place the button exactly where you want it.', 'add-as-preferred-source' ) . '
';
echo '' . esc_html__( 'A manually placed button always renders where you put it: the "Enable inline button", post type, and banner display rules do not apply to it.', 'add-as-preferred-source' ) . '
';
}
/**
* Shortcode badge style callback
*/
public function shortcode_style_callback() {
$style = $this->shortcode_default( 'style', 'default' );
?>
>
>
>
>
>
>
standard_inactive_tag(); ?>
shortcode_default( 'align', 'center' );
?>
>
>
>
shortcode_default( 'text', 'Stay connected via Google News' );
echo '' . esc_html__( 'The main title text. For the "Link" style, this is the underlined clickable phrase.', 'add-as-preferred-source' ) . '
';
}
/**
* Shortcode subtitle callback
*/
public function shortcode_subtitle_callback() {
$value = $this->shortcode_default( 'subtitle', 'Follow us for the latest travel updates and guides.' );
echo '' . esc_html__( 'The secondary text displayed below the title.', 'add-as-preferred-source' ) . '
';
}
/**
* Shortcode link style lead-in text callback
*/
public function shortcode_link_prefix_callback() {
$value = $this->shortcode_default( 'link_prefix', 'Enjoyed this article? You can' );
echo '' . esc_html__( 'Only used by the "Link" style - the sentence shown before the clickable phrase.', 'add-as-preferred-source' ) . '
';
}
/**
* Shortcode link style closing text callback
*/
public function shortcode_link_suffix_callback() {
$value = $this->shortcode_default( 'link_suffix', 'to see more from us.' );
echo '' . esc_html__( 'Only used by the "Link" style - the sentence shown after the clickable phrase.', 'add-as-preferred-source' ) . '
';
}
/**
* Shortcode background color callback
*/
public function shortcode_bg_color_callback() {
$value = $this->shortcode_default( 'bg_color', '#ffffff' );
echo '' . esc_html__( 'Skip the automatic inline button on posts that already contain the shortcode or block', 'add-as-preferred-source' ) . ' ';
echo '' . esc_html__( 'Useful when the inline button is enabled site-wide but a few posts place it by hand - without this, those posts show it twice.', 'add-as-preferred-source' ) . '
';
}
/**
* Builds the badge image URL for a language code and theme.
* Falls back to the English badge when the language file is missing.
*
* @param string|null $code Badge language code, or null for English.
* @param string $theme 'dark' or 'light'.
*/
private function badge_image_url( $code, $theme ) {
$dir = ( 'light' === $theme ) ? 'public/images/light/' : 'public/images/';
if ( $code && file_exists( ADASPRSO_PLUGIN_PATH . $dir . 'google-preferred-source-button-' . $code . '.png' ) ) {
return ADASPRSO_PLUGIN_URL . $dir . 'google-preferred-source-button-' . $code . '.png';
}
return ADASPRSO_PLUGIN_URL . $dir . 'google-preferred-source-button.png';
}
/**
* Returns the badge theme ('dark' or 'light') from a set of options.
*/
private function get_badge_theme( $options ) {
return ( isset( $options['badge_theme'] ) && 'light' === $options['badge_theme'] ) ? 'light' : 'dark';
}
/**
* Returns the URL of the custom uploaded badge image, or '' if none is set.
*
* @param array $options The plugin options.
*/
public function get_custom_image_url( $options ) {
$attachment_id = isset( $options['badge_custom_image_id'] ) ? absint( $options['badge_custom_image_id'] ) : 0;
if ( ! $attachment_id ) {
return '';
}
$url = wp_get_attachment_url( $attachment_id );
return $url ? $url : '';
}
/**
* Returns the badge image URL to use in admin previews, based on the saved options.
*
* @param array $options The plugin options.
* @param string|null $theme Optional theme override; defaults to the saved theme.
*/
public function get_preview_badge_url( $options, $theme = null ) {
if ( null === $theme ) {
$theme = $this->get_badge_theme( $options );
}
$setting = isset( $options['badge_language'] ) ? $options['badge_language'] : 'auto';
if ( $setting === 'custom' ) {
return '';
}
if ( $setting === 'upload' ) {
return $this->get_custom_image_url( $options );
}
if ( $setting === 'auto' ) {
$locale_map = array(
'da' => 'da', 'da_DK' => 'da',
'de' => 'de', 'de_DE' => 'de', 'de_AT' => 'de', 'de_CH' => 'de', 'de_DE_formal' => 'de',
'es' => 'es', 'es_ES' => 'es', 'es_MX' => 'es', 'es_AR' => 'es', 'es_CL' => 'es',
'et' => 'et', 'et_EE' => 'et',
'fi' => 'fi', 'fi_FI' => 'fi',
'fr' => 'fr', 'fr_FR' => 'fr', 'fr_BE' => 'fr', 'fr_CA' => 'fr', 'fr_CH' => 'fr',
'hi' => 'hi', 'hi_IN' => 'hi',
'he' => 'iw', 'he_IL' => 'iw',
'ja' => 'ja', 'ja_JP' => 'ja',
'ko' => 'ko', 'ko_KR' => 'ko',
'nb' => 'no', 'nb_NO' => 'no', 'nn_NO' => 'no',
'pt_BR' => 'pt-br',
'ru' => 'ru', 'ru_RU' => 'ru',
'sv' => 'sv', 'sv_SE' => 'sv',
'tr' => 'tr', 'tr_TR' => 'tr',
'uk' => 'uk', 'uk_UA' => 'uk',
);
$code = isset( $locale_map[ get_locale() ] ) ? $locale_map[ get_locale() ] : null;
} else {
$code = ( $setting === 'en' ) ? null : $setting;
}
return $this->badge_image_url( $code, $theme );
}
/**
* Returns the map of badge language codes to their display labels.
*/
public function get_available_badge_languages() {
return array(
'auto' => __('Auto (match site language)', 'add-as-preferred-source'),
'en' => 'English',
'da' => 'Dansk',
'de' => 'Deutsch',
'es' => 'Español',
'et' => 'Eesti',
'fi' => 'Suomi',
'fr' => 'Français',
'hi' => 'हिन्दी',
'iw' => 'עברית',
'ja' => '日本語',
'ko' => '한국어',
'no' => 'Norsk',
'pt-br' => 'Português (Brasil)',
'ru' => 'Русский',
'sv' => 'Svenska',
'tr' => 'Türkçe',
'uk' => 'Українська',
'custom' => __('Custom text (my language is not listed)', 'add-as-preferred-source'),
'upload' => __('Custom image (upload your own)', 'add-as-preferred-source'),
);
}
/**
* Badge language callback
*/
public function badge_language_callback() {
$saved = isset( $this->options['badge_language'] ) ? $this->options['badge_language'] : 'auto';
$languages = $this->get_available_badge_languages();
$options = is_array( $this->options ) ? $this->options : array();
$custom_text = isset( $this->options['badge_custom_text'] ) ? $this->options['badge_custom_text'] : '';
$is_custom = ( $saved === 'custom' );
$is_upload = ( $saved === 'upload' );
$custom_image_id = isset( $this->options['badge_custom_image_id'] ) ? absint( $this->options['badge_custom_image_id'] ) : 0;
$custom_image_url = $this->get_custom_image_url( $options );
echo '';
foreach ( $languages as $code => $label ) {
if ( $code === 'custom' || $code === 'upload' ) {
$preview_dark = '';
$preview_light = '';
} elseif ( $code === 'auto' ) {
$preview_dark = $this->get_preview_badge_url( $options, 'dark' );
$preview_light = $this->get_preview_badge_url( $options, 'light' );
} else {
$file_code = ( $code === 'en' ) ? null : $code;
$preview_dark = $this->badge_image_url( $file_code, 'dark' );
$preview_light = $this->badge_image_url( $file_code, 'light' );
}
printf(
'%s ',
esc_attr( $code ),
selected( $saved, $code, false ),
esc_url( $preview_dark ),
esc_url( $preview_light ),
esc_html( $label )
);
}
echo ' ';
$this->standard_inactive_tag();
printf(
'',
$is_custom ? '' : 'display:none;',
esc_attr( $custom_text ),
esc_attr__( 'e.g. Add as preferred source', 'add-as-preferred-source' ),
esc_html__( 'Enter the button text in your language. It will appear next to the Google logo, styled to match the badge.', 'add-as-preferred-source' )
);
printf(
'',
$is_upload ? '' : 'display:none;',
esc_attr( $custom_image_id ),
$custom_image_url ? '' : 'display:none;',
esc_url( $custom_image_url ),
esc_html__( 'Select Image', 'add-as-preferred-source' ),
$custom_image_url ? '' : 'display:none;',
esc_html__( 'Remove Image', 'add-as-preferred-source' ),
esc_html__( 'Choose an image from your Media Library to use as the badge. It will replace the Google button image in the banner and inline button.', 'add-as-preferred-source' )
);
echo '' . esc_html__( 'Choose which language badge to display. "Auto" detects the site language automatically and falls back to English if unavailable. If your language is not listed, select "Custom text (my language is not listed)" to enter your own button text — a custom badge will be generated with the Google logo and your text. Or select "Custom image" to upload your own badge image from the Media Library. We are adding more languages with each update — stay tuned!', 'add-as-preferred-source' ) . '
';
echo '' . esc_html__( 'This only sets the badge image\'s language. Google\'s own dialog language is set separately, under "Your own design" or "Google\'s own button" above.', 'add-as-preferred-source' ) . '
';
}
/**
* Badge theme callback
*/
public function badge_theme_callback() {
$theme = $this->get_badge_theme( is_array( $this->options ) ? $this->options : array() );
?>
>
>
standard_inactive_tag(); ?>
options['banner_trigger']) ? $this->options['banner_trigger'] : 'immediate';
?>
>
>
>
options['banner_scroll_percent']) ? (int) $this->options['banner_scroll_percent'] : 50;
$trigger = isset($this->options['banner_trigger']) ? $this->options['banner_trigger'] : 'immediate';
$style = ( $trigger !== 'scroll' ) ? 'display:none;' : '';
echo '';
}
/**
* Banner delay seconds callback
*/
public function banner_delay_seconds_callback() {
$seconds = isset($this->options['banner_delay_seconds']) ? (int) $this->options['banner_delay_seconds'] : 5;
$trigger = isset($this->options['banner_trigger']) ? $this->options['banner_trigger'] : 'immediate';
$style = ( $trigger !== 'time' ) ? 'display:none;' : '';
echo '';
echo '
' . esc_html__('seconds', 'add-as-preferred-source');
echo '
' . esc_html__('Show the banner after this many seconds on the page (1–60).', 'add-as-preferred-source') . '
';
echo '
>
>
options['banner_dismiss_days']) ? (int) $this->options['banner_dismiss_days'] : 7;
$frequency = ( isset( $this->options['banner_frequency'] ) && 'always' === $this->options['banner_frequency'] ) ? 'always' : 'remember';
$style = ( $frequency === 'always' ) ? 'display:none;' : '';
echo '';
echo '
' . esc_html__('days', 'add-as-preferred-source');
echo '
' . esc_html__('After a visitor closes the banner, keep it hidden for this many days (1–365).', 'add-as-preferred-source') . '
';
echo '
' . esc_html__('Control exactly where the banner appears on your site.', 'add-as-preferred-source') . '
';
}
/**
* Display On callback
*/
public function display_on_callback() {
$display_on = isset($this->options['display_on']) ? $this->options['display_on'] : 'everywhere';
?>
>
>
>
>
options['exclude_post_ids']) ? $this->options['exclude_post_ids'] : '';
echo '' . esc_html__('Enter comma-separated post or page IDs where the banner should never appear.', 'add-as-preferred-source') . '
';
}
/**
* Exclude Categories callback — renders a lightweight custom tag-search widget (no external library).
*/
public function exclude_categories_callback() {
$excluded = isset($this->options['exclude_categories']) ? array_map('intval', (array) $this->options['exclude_categories']) : array();
// Pre-load labels for already-selected categories only (typically a very small set).
$preloaded = array();
if (!empty($excluded)) {
$terms = get_terms(array(
'taxonomy' => 'category',
'include' => $excluded,
'hide_empty' => false,
));
if (!is_wp_error($terms)) {
foreach ($terms as $t) {
$preloaded[$t->term_id] = $t->name . ' (' . $t->count . ')';
}
}
}
echo '';
echo '
';
// Render a pill for each already-selected category.
foreach ($excluded as $cat_id) {
$label = isset($preloaded[$cat_id]) ? $preloaded[$cat_id] : '#' . $cat_id;
echo '';
echo '' . esc_html($label) . ' ';
echo '× ';
echo ' ';
}
echo '
'; // .adasprso-cat-tags
echo '
';
echo '
' . esc_html__('Search and select categories where the banner should not appear.', 'add-as-preferred-source') . '
';
}
/**
* AJAX handler — returns up to 20 categories matching a search string.
*/
public function ajax_search_categories() {
check_ajax_referer('adasprso_categories_nonce', 'nonce');
if (!current_user_can('manage_options')) {
wp_send_json_error('unauthorized');
}
// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- nonce already verified above
$search = isset($_GET['q']) ? sanitize_text_field(wp_unslash($_GET['q'])) : '';
$terms = get_terms(array(
'taxonomy' => 'category',
'search' => $search,
'number' => 20,
'hide_empty' => false,
));
$results = array();
if (!is_wp_error($terms)) {
foreach ($terms as $term) {
$results[] = array(
'id' => $term->term_id,
'text' => $term->name . ' (' . $term->count . ')',
);
}
}
wp_send_json(array('results' => $results));
}
}