Broadcast

Skildring

Network Content Syndication Made Easy!

Single source content on a WordPress multisite network is now as easy as pie! Syndicate posts to other blogs in the network, update posts between blogs, sync posts, share content templates, etc. Broadcasted posts can be linked to their parents, which updates child posts when the parent post is updated. This includes all data: title, slug, content, custom fields, attachments, etc.

Broadcast is great for:

  • Chain stores
  • Content hubs
  • Franchises
  • News sites
  • Schools
  • Anything else with distributed content!

Here are some use cases for Broadcast:

Broadcast

  • Posts, pages, custom post types
  • Taxonomies (categories, tags, etc)
  • Custom fields
  • Attached images
  • Hovudbilete
  • Galleri
  • Custom field blacklist, whitelist, and protect list.
  • User role access granularity
  • CDN support (nominally tested Amazon S3)
  • Many extra features in the add-on packs

SEO support

  • Canonical URLs of child posts.
  • Hreflang links (also see Hreflang add-on in the add-on packs)
  • Permalinks of child posts (also see Permalinks add-on in the add-on packs)
  • Yoast’s WordPress SEO plugin integration and support

Add-on Packs

There are several Broadcast add-on packs that expand the capabilities of Broadcast.

3rd party pack

The following add-ons add support for the plugin after which they are named:

If you don’t see your plugin in this list, it might not need a specialized add-on.

Control pack

These add-ons give you extra control of what you broadcast and how:

  • All Blogs gives all users access to all of the blogs in the network.
  • All Blogs Superadmin allows only superadmins to broadcast to all blogs in the network without having to be a user of the blog.
  • All Images detects all referenced local images in post text fields and adds them to the broadcast.
  • Back To Parent updates the parent post with the new child content.
  • Comments adds support for broadcasting of comments.
  • Custom Field Attachments allows post custom field containing attachment IDs to be broadcasted correctly.
  • Custom Field Posts allows post custom field containing post IDs to be broadcasted correctly.
  • Custom Field Terms allows post custom field containing taxonomy term IDs to be broadcasted correctly.
  • Delete Before Broadcast deletes duplicate and similar child posts on each blog before broadcasting.
  • Gutenberg Attachments: Modify attachment IDs found in Gutenberg blocks to match their equivalent attachments on each blog.
  • Gutenberg Menus: Modify menu IDs found in Gutenberg blocks to match their equivalent attachments on each blog.
  • Gutenberg Posts: Modify post IDs found in Gutenberg blocks to match their equivalent attachments on each blog.
  • Gutenberg Protect: Protects specific Gutenberg blocks from being overwritten during broadcasting.
  • Gutenberg Terms: Modify taxonomy term IDs found in Gutenberg blocks to match their equivalent attachments on each blog.
  • Hreflang adds support for SEO-friendly hreflang html tags.
  • Keep Child Status keeps the status of post children to private, pending, published, draft, no matter the status of the parent.
  • Link Before Broadcast attempts to find unlinked children on each child blog during broadcast.
  • Local Files automatically copies local files to each blog and updates the links in the content.
  • Local Links automatically updates links to local posts on each child blog.
  • No New Terms prevents taxonomy terms from being created on child blogs.
  • Parent Pull allows content to be pulled from (parent) blogs.
  • Per Blog Taxonomies allows individual control of specific taxonomies for each child post.
  • Permalinks provides more precise control of permalinks for both parents and children.
  • Protect Child Properties prevents various properties of child posts from being overwritten.
  • Rebroadcaster: Periodically and automatically rebroadcast specific posts.
  • <a href="https://broadcast.plainviewplugins.com/addon/rebroadcast-parent-here/"Rebroadcast Parent Here: Rebroadcast the parent to this linked child.
  • Redirect All Children redirects single post views from visitors of child posts to the parent post.
  • Redirect Parent redirect all views of a parent post to the first child post.
  • Relink To Parent: Relink an unlinked child to the parent.
  • Same post ID: Create a new post on several blogs with the same post ID.
  • Search And Replace finds and replaces texts in posts during broadcast.
  • Shortcode Attachments modifies attachment IDs found in shortcodes to match their equivalent attachments on each blog.
  • Shortcode Menus modifies menu IDs found in shortcodes to match their equivalent menus on each blog.
  • Shortcode Posts modifies post IDs found in shortcodes to match their equivalent posts on each blog.
  • Shortcode Terms automatically translates taxonomy term IDs found in shortcodes when broadcasting.
  • Term Meta Attachments: Allow taxonomy term meta containing attachment IDs to be broadcasted correctly.
  • Thumbnail Sizes allows for different additional thumbnail sizes on a per-blog basis.
  • Update Attachments updates existing attachments by copying over the files to the child blogs.
  • Update Family updates the parent post and siblings when editing a child post.
  • Unlink On Edit unlinks child posts when they are modified.
  • User & Blog Settings (UBS) can hide the broadcast meta box and/or menu, modify the meta box to force/prevent broadcast to blogs, with separate settings for users / blogs / roles.
  • User & Blog Settings Post uses the modifications from the UBS plugin to broadcast posts with one click.

Efficiency pack

These add-ons allow you to broadcast more efficiently, saving you even more time:

  • Blog Groups 2 provides a means of groups blogs together, in order to be able to quickly select and unselect blogs from the Broadcast meta box.
  • Blog Search: Search and filter the blog list in the editor meta box.
  • Duplicate Attachments will duplicate the attachment and thumbnails, instead of letting WordPress regenerate them.
  • Find Some Unlinked Children can selectively link orphans / unlinked posts to parents, instead of automatically linking all found children.
  • New Blog Broadcast automatically broadcasts posts when creating a new blog.
  • Purge Children removes children and their attached files from child blogs.
  • Queue adds a broadcast queue which helps to broadcast posts to tens / hundreds / thousands of blogs.
  • Rebroadcast updates selected parent posts by using a bulk action.
  • Rebroadcaster: Periodically and automatically rebroadcast specific posts.
  • Send To Many allows mass broadcast of several posts to blogs at once.

Utilities pack

These add-ons do things semi-related to broadcasting, but are good to have none-the-less:

  • Bulk Cloner creates clones of existing blogs on the network.
  • CDN Workaround works around faulty CDNs that do not report the correct URL for attachments.
  • : Run code snippets on specific blogs.
  • Copy options copies blog options / settings between blogs.
  • : Runs WordPress cron periodically on all sites of the network.
  • Custom Field Cleanup: Cleans up the custom fields of a post.
  • Lock Post allows users to lock editing of posts / pages to only themselves and super admins.
  • Manual Post Actions manually runs bulk post actions on posts.
  • Media Cleanup: cleans up unused media by looking for unused items in the database and on disk.
  • Menus copies menus between blogs (overwrite / update), with support for equivalent child posts on the child blogs and equivalent taxonomies.
  • Page Content Shortcode provides a [bc_page_content slug="pageslug"] shortcode to display the contents of a page.
  • PHP Code runs custom PHP code on selected blogs. Easily switch themes for all blogs, for example.
  • Shortcodes provides arbitrary admin-defined global or local shortcodes.
  • Sitemaps generates network-aware sitemaps and robots.txt.
  • Sync Taxonomies synchronizes the taxonomies of target blogs with those from a source blog.
  • User Role Sync copies user roles between blogs.
  • Widgets copies widget and sidebar settings between blogs.

Dokumentasjon

Although Broadcast is relatively easy to understand by itself, for extra documentation see Broadcast’s online documentation, which covers:

Here are instructions for merging existing single installs into a WordPress network.

For developers: the code should be well-commented and easily legible for the most part. Extra developer documentation covers:

Misc

The git repository can be found at: https://bitbucket.org/edward_electric/broadcast

Skjermbilete

  • Broadcast meta box when editing posts
  • How posts and pages can be broadcasted
  • Post overview showing linked children
  • Post overview showing linked parents
  • Bulk actions that can be applied to several marked posts at once
  • Post actions for parent posts
  • Post actions for child posts
  • The Broadcast menu
  • Admin settings tab
  • Maintenance tab
  • Uninstall tab
  • Time savings tab showing how much time Broadcast has saved you

Installasjon

  1. Activate the plugin sitewide.

Vanlege spm.

I need support!

Broadcast is supported in the forum. For users of the add-on packs, support is available via e-mail.

Debug dumps

A debug dump is the long text that is displayed when broadcasting a post with debug mode on. This dump can then be read to see what Broadcast is or isn’t doing.

To switch on debug mode, see the admin settings. If your site is live it would be wise to input your IP in the associated textarea, so that only you see the debug dump.

Gutenberg support?

Yes, works as normal with one exception: the meta box does not update after publishing, so you’ll have to reload the page after publishing changes to see the new blogs list.

Blacklist, whitelisting, force broadcast

Broadcasting to specific blogs, hiding blogs and forcing blogs can be acheived with the User & Blog Settings add-on.

Bulk broadcast existing pages

To broadcast many posts at once, see the Send To Many add-on.

Galleries and attachments

How broadcast handles attachments:

  1. Attachments directly attached are stored.
  2. Attachments found in [gallery] shortcodes are stored.
  3. On the child blog, the existing attachments to the post, if any, are automatically deleted to keep attachments clean. This behavior can be configured using custom code or add-ons: Duplicate Attachments, Update Attachments.
  4. The stored attachments are copied.
  5. The thumbnail ID is replaced.
  6. The image URLs in the post content are replaced.
  7. The image IDs in [gallery] shortcodes are replaced.

Do you have a lot of attachments that you don’t want duplicated to hundreds of child blogs, in order to save space? You’ll have to find a way to refer to the images statically instead of using their media IDs. The reason for this is that when WordPress is referred to an attachment, it can only read the media IDs from the current blog. It cannot switch blogs in order to load the image.

Hide broadcast from the users

The broadcast meta box, menu and columns in the post view can be hidden from users / roles / blogs using the User & Blog Settings add-on.

Incompatible plugins

Below is a list of plugins that just will not work properly with Broadcast and / or its addons:

  • Cloudflare Image Resizing – Creates 404 errors for images.
  • Intuitive Custom Post Order – Prevents broadcasting due to switch_to_blog() mismatch.
  • Post Type Switcher – Turns post types into attachments and vice versa.
  • Query Monitor causes the queue data to increase exponentially.
  • Theia Smart Thumbnails Premium
  • Tracking Code Manager – prevents User & Blog Settings from working by inserting data into the _POST variable during a normal page GET. Very non-standard behavior.

Orphans?

If you have already created posts on other blogs that are supposed to be children of a specific post, you can use the «find unlinked» bulk action to find and link them.

If the existing posts are not linked, broadcasting a post can result in duplicates.

To be considered an orphan the orphaned posts must have the exact same title (name) as the soon-to-be parent and be of the same post type.

You can also use the Delete Before Broadcast add-on to delete any similar posts on the child blog before broadcasting.

Timeout problems

If you have many attachments in your post, and are broadcasting the post to many blogs, you might encounter a PHP timeout. This means that broadcasting exceeded the PHP time limit and had to be aborted.

There are several solutions to this problem:

  1. Increase the PHP timeout in your PHP.ini settings. This will not speed up broadcasting, only increase your chances of completely broadcasting the post.
  2. Use the Duplicate Attachments add-on. This will duplicate any attachments + thumbnails instead of regenerating them on each child blog.
  3. Use the Queue add-on to put each child broadcast into a queue that is emptied by javascript.

You will not need solution #1 if you use solutions #2 and #3. 🙂

Why can I not see the Broadcast meta box?

Make sure that:

  1. Your user level has broadcast access (Broadcast access role)
  2. Your user has write access to more than this blog (see Admin settings > Maintenenace > View blog access). You can also use the All Blogs add-on to give yourself access to all blogs.
  3. The correct post type(s) have been selected in the Broadcast settings
  4. The User & Blog Settings add-on is not set to hide the meta box from the user / role / blog

WooCommerce

Broadcast is capable of handling simple WooCommerce products.

  1. In the Broadcast custom post type settings: Add «product».
  2. Save the product normally first.
  3. Then broadcast, selecting the custom fields and taxonomies checkboxes.

This will broadcast all normal product settings: SKU, price, etc.

If your products have variations, a product image gallery, you want to sync stock, you want to sync orders, need the attribute taxonomies to be synced, you’ll be wanting the WooCommerce add-on.

Omtalar

19. oktober 2023
This plugin solved a lot of problems creating our sister site for EU customers. There are many features that make this a very flexible plugin. The tech support was fast and helpful. Worth the upgrade to the pro version.
22. august 2023
I couldn't recommend this plugin enough if using WP multisite.It has been an absolute game changer for our business.Great, fast support as well.
25. mai 2023
Edward went out of his way to implement changes into the plugin that allowed me to sync unsupported field formats. This has saved me hours! Can't recommend this plugin enough.
4. mai 2023
As a website developer, I can say that it is one of the best plugins for Broadcast you can find. It helps to publish your pages along with many add-ons. It is a plugin that you definitely recommend, especially for those who use multisite Wordpress. Especially when you encounter a problem, you will get an immediate response and they will help you to solve the problem. Edward does an excellent job. He deals with your problems as if they were his own. Thanks Edward for such a nice support and plugin.
7. april 2023
I've been using wordpress for 10 years and experience with 100s of plugins and working with support - single devs, small agencies and full-on companies. I don't hesitate for 1 second to say that Edward's level of support is second to NONE. I run a multisite network with 60+ subsites, so bought the premium addon back and it has been worth EVERY SINGLE PENNY. It's so comprehensive in in what it supports, I have yet to run into anything that wasn't supported (or support not added almost immediately when requested), and I have far from a "standard" set up. I've been using this for 6 months now and I'm still blown away every time I use it or contact Edward and how quickly he gets back, remembers, cares, etc - I kid you not he's really in a league of his own over here. If you're contemplating this plugin - for one, there's legitimately no competitor. Nothing out there does what this does. Secondly, you can proceed with 100% confidence in your purchase. This plugin is unreal and so is it's developer.
Les alle 200 omtalar

Bidragsytarar og utviklarar

“Broadcast” is open source software. The following people have contributed to this plugin.

Contributors

“Broadcast” er omsett til 2 språk. Takk til omsetjarane for bidraga deira.

Omset “Broadcast” til ditt eige språk.

Interested in development?

Les kjeldekoden, sjekk SVN-lageret eller abonner på utviklingsloggen med RSS.

Endringslogg

50.07 20240210

  • Update SDK
  • Update Tested with

50.06 20231108

  • Fix: Added Cloudflare Image Resizing plugin to the list of incompatible plugins.
  • Tweak: Don’t show «Preparsing» debug text if there are more than 5 terms in the taxonomy.
  • Dev: Add get_user_writable_blogs::remove_access() method.

50.05 20230918

  • Fix: Fix error message when clicking on things in the broadcasted column. The problem was a double nonce – one form nonce is enough.

50.04 20230913

  • Fix: Remove «attachment» as a broadcastable post type in the settings. Attachments can only really be broadcasted by being used in posts.
  • Tweak: Tested with 6.3
  • Tweak: Added hook priority info in info table.

50.01 20230407

New add-on: Same post ID: Create a new post on several blogs with the same post ID.
* Code: SDK update for PHP 8.2 compatibility.

50 20230407

New add-on: Skip If Unlinked: Do not broadcast to blogs that have an existing, unlinked post.
* Code: Add API support for finding equivalent image IDs on blogs. See the api() get_equivalent_image_id() and get_equivalent_image_ids() functions./

49.07 20230325

  • Code: SDK update for PHP 8.1 compatibility. No other changes.

49.06 20230303

  • New: Custom post type inclusion and exclusion lists added. Thanks to @jblifestyles from @hivedigital.
  • Code: Add Gutenberg helper functions.

49.05 20230210

  • Code: find_unlinked_children post action now accepts a list of blogs to link to. Affects the API and the Bulk CLoner and Find Some Unlinked Children add-ons.

49.04 20230127

  • New add-on: Search Exclude: Adds support for the Search Exclude plugin.
  • Fix: Featured image (_thumbnail_id) handler now obeys custom field protect list, allowing the featured image to be protected.
  • Fix: Fix javascript path for Windows installs.

49.02 20230104

  • Fix: Fix javascript for post actions.
  • Code: Mark parent terms as used also, so that they get synced (and allow add-ons to handle the terms also).
  • Code: More php 8.1 fixed

49.01 20221225

  • Code: Add broadcast_menu_target filter to allow the displayed menu override: all settings, broadcast info or no menu at all.

48.15 20221031

  • Code: Broadcast now requires at least php 7.4
  • Code: Increase compatibility with php 8.1.

48.15 20221031

  • Version bump for WP 6.1
  • Fix: Allow for PHP 7.2 again. I just needed to remove a comma in the code.

48.14 20221008

  • Fix: During maybe_sync_taxonomy(), mark the taxonomy as synced as soon as possible. This is to prevent looping in add-ons such as ACF, where taxonomies can be referred to by other taxonomies.
  • Fix: When trashing parent and child posts, avoid doing the work double.
  • New add-on: Blog Search: Search and filter the blog list in the editor meta box.
  • New add-on: JetEngine: Adds support for JetEngine custom post types.
  • New add-on: <a href="https://broadcast.plainviewplugins.com/addon/rebroadcast-parent-here/"Rebroadcast Parent Here: Rebroadcast the parent to this linked child.
  • New add-on: Relink To Parent: Relink an unlinked child to the parent.
  • Code: Add trash_untrash_delete_post action.
  • Code: Link the post directly after creating it, instead of waiting until all attachments and taxonomies are synced.

48.12 20220727

  • Dev: Add helper methods to prepare_meta_box action.

48.11 20220525

  • Version bump for WP 6.0

48.09 20220418

  • Fix: Exception when being activated on single installs.

48.07 20220226

  • Fix: Prevent WordPress from removing iframe tags in the post content.
  • Fix: Prevent Broadcast from being activated on single installs. Fixed the activate() on null error.

48.06 20220129

  • Tweak: Compatible with WP 5.9
  • Fix: Increase compatibility with PHP 8.1 by renaming the SDK’s form class «readonly» trait.

48.05 20220106

Happy new year!

  • Fix: Mark taxonomies as synced earlier, preventing an infinite loop when a taxonomy has ACF fields that refer back to itself.
  • Fix: Execute the each_linked_post action on the parent post itself when called from the parent post.

48.04 20211118

  • Fix: Correctly detect true/false term meta values when trying to protect them.
  • Fix: Remove warning about the Term Index get() function not matching.
  • Code: Add canonical_url action to allow for more flexible canonical URL handling.

48.03 20211112

  • Fix: Selected taxonomy terms lost their parents if the parents weren’t also selected.

48.02 20211110

  • Fix: Add extra compatibility with PHP 7.2 (which has not been supported for a year, btw). Please upgrade!

48.01 20211105

  • New add-on: Code Snippets: Run code snippets on specific blogs.
  • New add-on: Cron Everywhere: Runs WordPress cron periodically on all sites of the network.
  • New add-on: Rebroadcaster: Periodically and automatically rebroadcast specific posts.
  • Tweak: Only used taxonomies are synced now. This prevents the child from receiving all of the taxonomies of the parent when extra taxonomies are synced via the Custom field / Gutenberg / Shortcode Terms add-ons, for example. Anything that uses taxonomies()->also_sync().
  • Code: Add equivalent_posts() sharing, so that subbroadcasts have access to the same equivalent_posts().
  • Code: Add broadcasting_data->equivalent_posts()->broadcast_once() method to broadcast a post once and then use the existing child ID.