YT Sub Counter
| 开发者 |
myndsyn
ronknight |
|---|---|
| 更新时间 | 2026年8月27日 12:53 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
[ytsub] shortcode. The block works in posts, pages and the Site Editor, so you can drop it into a header, footer or sidebar template, or sit it in a Row next to core's Social Icons block as one more social button.
Site-wide defaults are configured under Settings > YT Sub Counter:
- Channel ID
- Layout (default or full)
- Theme (default or dark)
- Subscriber count visibility (shown or hidden)
[ytsub theme="dark" count="hidden"].
The "Youtube Subscribers" widget is still included and existing widgets keep working, but it is legacy. Block themes have no widget areas at all, so the block is the way to place the button there.
安装:
- Upload the plugin files to the
/wp-content/plugins/show-youtube-subscribers-countdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the 'Plugins' screen in WordPress.
- Go to Settings > YT Sub Counter and enter your YouTube Channel ID. You can find your Channel ID at https://www.youtube.com/account_advanced
- Edit any post, page or template and add the "YouTube Subscribe" block, or use the
[ytsub]shortcode.
屏幕截图:
常见问题:
Nothing is displayed
Check that a Channel ID is set under Settings > YT Sub Counter, or directly on the block, shortcode or widget. The button is not rendered when no channel is configured.
The button shows an error
Make sure you've entered a valid YouTube Channel ID, not a custom URL or a handle beginning with @. Your Channel ID is the string starting with "UC" shown at https://www.youtube.com/account_advanced
I can't find Appearance > Widgets
Block themes, including the recent default WordPress themes, do not have widget areas, so the Widgets screen does not exist for them. Use the "YouTube Subscribe" block instead. In the Site Editor you can add it to any template, including headers and footers, which is where a sidebar widget would once have gone.
How do I show it next to my other social icons?
Add a Row block, put core's Social Icons block in it, then add the "YouTube Subscribe" block beside them. The Row's alignment controls will line them up. The subscribe button is rendered by YouTube, so it keeps YouTube's own styling rather than inheriting your social icon colours.
Is the widget going away?
Existing widgets keep working and there is no plan to remove the widget. It is no longer the recommended way to add the button, because WordPress itself has moved on from widget areas.
Can I show more than one channel?
Yes. Set the channel on the shortcode itself, for example [ytsub channel="UCxxxxxxxxxxxxxxxxxxxxxx"]. Any shortcode attribute overrides the site-wide setting.
What shortcode attributes are available?
channel, layout (default or full), theme (default or dark) and count (default or hidden). Anything you omit falls back to the setting saved under Settings > YT Sub Counter.
更新日志:
- Improve: the settings screen is laid out in cards, with the channel and appearance options separated and instructions for the block, shortcode and widget alongside them.
- New: a preview of the subscribe button on the settings screen that updates as you change layout, theme and count.
- New: the block shows that same preview on the canvas, instead of a grey placeholder box, so it looks like what visitors will see.
- New: the block uses the YouTube mark as its icon in the inserter and list view.
- New: copy button for the [ytsub] shortcode, and help tabs on the settings screen.
- Improve: a warning on the settings screen, and in the block, when no channel ID is set and nothing will be displayed.
- Assets: plugin icon and header image for the plugin directory.
- New: settings screen under Settings > YT Sub Counter for site-wide defaults.
- New: "YouTube Subscribe" block, for posts, pages and the Site Editor. This replaces the widget on block themes, which have no widget areas, and can sit in a Row alongside the Social Icons block.
- New: [ytsub] shortcode, for templates and other places blocks are not available.
- New: Settings link on the plugins screen.
- Improve: widget options left empty now fall back to the site-wide settings.
- Fix: option values (default, full, dark, hidden) were passed through translation functions, which could break the button on non-English sites.
- Harden: channel IDs and select values are validated against an allow list on save and on output.
- Privacy: Google's platform.js is now loaded only on pages that actually display a subscribe button, instead of on every front-end page.
- Remove: an empty stylesheet and a placeholder script that were enqueued on every front-end page.
- Docs: describe when platform.js is loaded, and correct the screenshot list.
- Update: requires WordPress 6.3, for the block's apiVersion 3 and iframe editor compatibility.
- Update: tested up to WordPress 7.1.
- Fix: "Tested up to" now correctly lists only the major WordPress version.
- Docs: disclose the external YouTube/Google platform.js service in this readme.
- I18n: text domain corrected to match the plugin slug (show-youtube-subscribers-count).
- Security: escape the filtered widget title with esc_html() before output.
- Fix: renamed the generic "google" script handle to the prefixed "ytsub-youtube-platform".
- Security: escape widget output (channel, layout, theme, count) with esc_attr() to prevent stored XSS via widget settings.
- Fix: enqueue js/main.js as a script instead of a stylesheet.
- Fix: correct asset URL resolution so css/js load from the plugin root.
- Update: tested up to WordPress 7.0.2.
- Add theme options dark and default.
- Correct error when using a non custom YouTube URL.
- Initial release.