FLASH SALE Get 20% OFF everything using the coupon code: FLASH20 View Pricing Plans →

Knowledge Base

Documentation

Theme Documentation



Plugin Documentation



Resources

Social Icons Widget PRO – Plugin Settings

This article refers to Social Icons Widget PRO

The Settings page is the central place to configure how the plugin behaves across your site. From here you can enable or disable the widget and block, manage analytics and sharing behavior, set up Pinterest image hover pins, and upload custom SVG icons.

All settings are accessed from Sharing Buttons > Settings in the WordPress admin menu.


1. Accessing the Settings Page

  1. In the WordPress admin menu, go to Sharing Buttons > Settings.
  2. The page opens with three tabs along the top: Settings, Pinterest, and Upload Icons.

Important: All three tabs share a single form. When you click Save Changes, every setting across all tabs is saved at once. You do not need to save each tab individually.


2. Settings Tab (General)

The Settings tab controls the core plugin features: widget and block availability, analytics tracking, share link behavior, and the SharedCount API integration.

Disable Social Icons Widget

  • Field label: Social Icons Widget
  • Type: Checkbox (labeled “Disable”)
  • Default: Unchecked (widget is enabled)

Check this box to disable the legacy WordPress widget. When disabled, the “Social Icons by WPZOOM” widget will no longer appear in the Appearance > Widgets screen, and any existing widget instances will stop rendering on the frontend.

This is useful if you exclusively use the Gutenberg block or shortcode and want to declutter the widget list.

Disable Social Icons Block

  • Field label: Social Icons Block
  • Type: Checkbox (labeled “Disable”)
  • Default: Unchecked (block is enabled)

Check this box to disable the Gutenberg block. When disabled, the “Social Icons” block will no longer appear in the block inserter. Existing block instances already placed in posts or pages will stop rendering on the frontend.

This is useful if you only use the classic widget or shortcode and do not need the block editor integration.

SharedCount API Key

  • Field label: SharedCount API Key
  • Type: Text input
  • Default: Empty (uses the bundled default key)
  • Placeholder: “Optional override key”

A default SharedCount API key is bundled with the plugin, so Facebook and Pinterest share counts work out of the box without any configuration. You only need to enter your own key here if you want to override the default — for example, to get higher rate limits on a high-traffic site.

To get your own key, sign up for a free account at sharedcount.com and paste the key into this field.

Click Tracking

  • Field label: Click Tracking
  • Type: Checkbox (labeled “Enable”)
  • Default: Checked (tracking is enabled)

When enabled, the plugin records a click event every time a visitor clicks one of your sharing buttons (X, LinkedIn, Threads, Reddit, Telegram, WhatsApp, Bluesky, ChatGPT, Claude, Perplexity, Email, Copy Link, and Print). Click data appears in the Share Analytics dashboard.

Disabling this option stops new click events from being recorded. Existing click data is not deleted — it remains in the database and continues to appear in analytics reports.

This setting does not affect like tracking, which is always active. It also does not affect Facebook and Pinterest share counts, which are pulled from the SharedCount API rather than tracked via clicks.

  • Field label: Share Link Behavior
  • Type: Dropdown select
  • Options:
  • Popup Window (default) — Share links open in a small popup window.
  • New Tab — Share links open in a new browser tab.

This controls how sharing links behave when a visitor clicks a sharing button on the frontend. The popup window option provides a more focused sharing experience, while the new tab option may be preferred for accessibility or user preference reasons.

Clear Analytics Data

  • Field label: Clear Analytics Data
  • Type: Button (labeled “Clear All Analytics Data”)

Clicking this button permanently deletes all analytics data collected by the plugin. A confirmation dialog appears before any data is removed.

What gets deleted:

  • All click tracking records from the database.
  • All cached external share counts (stored as post meta).
  • The site-wide aggregated share summary.
  • All SharedCount API cache entries.

What is NOT deleted:

  • Like data (stored in a separate table) is not affected.
  • Plugin settings remain unchanged.

This action cannot be undone. Use it only if you need to start fresh with your analytics data.


3. Pinterest Tab

The Pinterest tab configures the image hover pin feature. When enabled, a “Pin it” button appears over images in your post content when visitors hover over them, making it easy for readers to save your images to Pinterest.

Enable Image Hover Pins

  • Field label: Enable Image Hover Pins
  • Type: Checkbox (labeled “Enable”)
  • Default: Unchecked (disabled)

Check this box to activate the Pinterest hover pin feature. When enabled, a “Pin it” button will overlay images inside your post content whenever a visitor hovers over them.

Button Position

  • Field label: Button Position
  • Type: Dropdown select
  • Options: Top Left (default), Top Right, Bottom Left, Bottom Right

Controls where the “Pin it” button appears relative to the image. Choose the corner that works best with your site’s layout and avoids overlapping important parts of your images.

Button Shape

  • Field label: Button Shape
  • Type: Dropdown select
  • Options: Rectangular, Rounded (default), Circular

Sets the visual shape of the hover pin button. Choose the style that best matches your site’s design.

Minimum Image Width (px)

  • Field label: Minimum Image Width (px)
  • Type: Number input
  • Default: 200

Images narrower than this value (in pixels) will not display the “Pin it” button on hover. This prevents the button from appearing on small decorative images, icons, or thumbnails where pinning would not be useful. Set to 0 to disable the width threshold entirely.

Minimum Image Height (px)

  • Field label: Minimum Image Height (px)
  • Type: Number input
  • Default: 200

Images shorter than this value (in pixels) will not display the “Pin it” button on hover. Like the width setting, this helps exclude small images from the hover pin feature. Set to 0 to disable the height threshold entirely.

Show Button Label

  • Field label: Show Button Label
  • Type: Checkbox (labeled “Enable”)
  • Default: Checked (label is shown)

When enabled, a text label appears next to the Pinterest icon on the hover button. When disabled, only the Pinterest icon is displayed. Showing the label makes the button’s purpose more obvious to visitors who may not recognize the Pinterest icon.

Button Text Label

  • Field label: Button Text Label
  • Type: Text input
  • Default: “Save”

Sets the text displayed on the hover pin button when Show Button Label is enabled. Common choices include “Save,” “Pin it,” or “Pin.” This field has no effect when the label is disabled.

Post Type Display

  • Field label: Post Type Display
  • Type: Checkboxes (one per public post type)
  • Default: Post

Select which post types should display the Pinterest hover pin button. Only public post types are listed (the Attachment post type is excluded). Check the box next to each post type where you want hover pins to appear.

For example, if your site uses Posts and Pages, you might enable hover pins on both. If you have a custom “Recipe” post type, it will also appear in this list.

Always Show on Mobile

  • Field label: Always Show on Mobile
  • Type: Checkbox (labeled “Enable”)
  • Default: Unchecked (hidden on mobile)

By default, hover pins are hidden on screens below 768px wide because touch devices do not have a hover interaction. Enabling this option forces the “Pin it” button to always be visible on images, even on mobile devices, so visitors can tap it directly.

Skip CSS Classes

  • Field label: Skip CSS Classes
  • Type: Text input
  • Default: Empty
  • Placeholder: “no-pin, skip-pin”

Enter a comma-separated list of CSS class names. Any image (or its parent <figure> element) that has one of these classes will not show the “Pin it” hover button. This lets you selectively exclude specific images from the feature.

For example, entering no-pin, site-logo would prevent the hover button from appearing on images with either the no-pin or site-logo class.

Note: Images with the standard Pinterest nopin="nopin" HTML attribute are always skipped automatically, regardless of this setting.


4. Upload Icons Tab

The Upload Icons tab lets you upload your own custom SVG icons to create a personalized icon set. This is a Pro-exclusive feature.

Overview

Uploaded SVG icons become available in the Custom Icons category whenever you add social icons to your site — whether through the widget, block, or shortcode. This is useful when you need icons for platforms or services that are not included in the bundled icon libraries.

Uploading a new icon

  1. On the Upload Icons tab, click the Upload an SVG icon button.
  2. The WordPress Media Library opens. Select an existing SVG file or upload a new one.
  3. After selecting the file, a preview of the icon appears in the upload area.
  4. Click Add icon to set to save the icon to your custom icon set.

The icon is immediately available in the “Custom Icons” category for use across all social icon placements.

Security note: All uploaded SVG files are sanitized using the enshrined/svg-sanitize library to remove potentially harmful code before they are stored.

Managing uploaded icons

Once you have uploaded one or more icons, an Uploaded Icons section appears below the upload area. Each icon is displayed with a preview and a checkbox.

To remove icons:

  1. Check the box next to each icon you want to delete.
  2. Click Update to confirm the removal.

Removed icons will no longer appear in the “Custom Icons” category.

Icons persist through settings reset

Custom uploaded icons are intentionally preserved when you use the Reset All Settings button (described in the next section). Your icon library is not affected by a settings reset, so you do not need to re-upload icons after resetting.


5. Saving and Resetting Settings

Saving changes

Click the Save Changes button at the bottom of the settings form to save all settings across all three tabs at once. A success notice appears at the top of the page confirming that settings have been saved.

Because all tabs share one form, any changes you make on the Settings tab, the Pinterest tab, and the Upload Icons tab are all submitted together when you save.

Reset All Settings

A Reset All Settings button appears below the main form area. Clicking it restores every setting to its default value.

Before the reset takes effect, a confirmation dialog asks: “Are you sure you want to reset all settings to defaults? Custom icons will be preserved.”

What gets reset:

  • All fields on the Settings tab return to their defaults (widget enabled, block enabled, click tracking enabled, popup share behavior, empty API key override).
  • All fields on the Pinterest tab return to their defaults (hover pins disabled, top-left position, rounded shape, 200px minimum dimensions, label shown with “Save” text, only Posts enabled, mobile display disabled, no skip classes).

What is NOT reset:

  • Custom uploaded icons are preserved. Your icon library remains intact.
  • Analytics data is not affected by a settings reset. To clear analytics data, use the dedicated Clear All Analytics Data button on the Settings tab.

Last updated on February 17, 2026