Multisite

Updated

The Multisite add-on provides new notifications for WordPress Multisite installations. All Multisite notifications need to be created on the primary site on the Multisite network to work correctly.

A selection of newly available notifications to customise in the Multisite add-on.

An update was released alongside the release of this add-on to the free core plugin that provides support for any regular notifications included within the free core BNFW plugin that weren’t working correctly under a multisite installation. As such, you only need to purchase this add-on if you’d like to take advantage of the new notifications that this add-on provides. These are:

New Site Activated or Created – For Network Admin
This notification is sent when a new site is activated by the user or a new site is directly added within the WP Admin by an Administrator. This notification is sent to the network admin.

Due to a restriction within WordPress, it is not possible to override the subject of this notification. As such, it will always be hardcoded as “New Site Registration: X”, where X is the new site URL. Additionally, there are no shortcodes available to use within this notification in either the subject or the message body due to the same restriction. You can change the text and other content as normal however.

Please Note: In addition to this notification, there is also another notification that is sent to the network admin with a subject of “X New Site Created”. There is no way to either disable or override this email, again, due to a restriction within WordPress.

New User Created – For Network Admin
This notification is sent when a new user is added to a site or when the new user who was added to a site activates their account. This notification is sent to the network admin.

Due to a restriction within WordPress, it is not possible to override the subject of this notification. As such, it will always be hardcoded as “New User Registration: X”, where X is the new user’s username.

This notification can use any of the [cc lang=”php” inline=”true”][email_user_*][/cc] shortcodes in the message body only of the notification.

Network Admin Email Change Attempted – For New Network Admin
This notification is sent when an attempt is made to change the network admin email address and is sent to the new network admin email address.

Due to a restriction within WordPress, it is not possible to override the subject of this notification. As such, it will always be hardcoded as “X New Network Admin Email Address”, where X is the network name.

[cc lang=”php”]

Confirmation Link: [confirmation_link]

[/cc]

This notification can also use any of the [cc lang=”php” inline=”true”][new_admin_user_*][/cc] shortcodes in the message body only of this notification. These shortcodes will only output correctly if the new network admin email address matches that of an existing user within the network.

Network Admin Email Changed – For Old Network Admin
This notification is sent when the network admin email address has been changed and is sent to the old network admin email address.

This notification can also use any of the [cc lang=”php” inline=”true”][old_admin_user_*][/cc] and [cc lang=”php” inline=”true”][new_admin_user_*][/cc] shortcodes in the subject and message body of this notification. These shortcodes will only output correctly if the old and/or new network admin email address matches that of an existing user within the network.

New Site Activated or Created – For Site Admin

This notification is sent when a new site is activated by the user or a new site is directly added within the WP Admin by an Administrator. This notification is sent to the site admin.

Due to a restriction within WordPress, it is possible to override the subject of this notification however, no shortcodes can be used.

You can use shortcodes in the message body though. Available shortcodes for this are:

[cc lang=”php”]

ID of the New Site: [blog_id]
Title of the New Site: [title]

[/cc]

Site Deleted – For Site Admin
This notification is sent when a user deletes their site via Tools > Delete Site in the WP Admin. This notification is sent to the site admin.

Due to a restriction within WordPress, it is not possible to override the subject of this notification. As such, it will always be hardcoded as “[ X ] Delete My Site”, where X is the name of the site that was deleted. Additionally, there are no shortcodes available to use within this notification in either the subject or the message body due to the same restriction. You can change the text and other content as normal however.

Site Admin Email Change Attempted – For New Site Admin
This notification is sent when an attempt is made to change the site admin email address and is sent to the new site admin email address.

Due to a restriction within WordPress, it is not possible to override the subject of this notification. As such, it will always be hardcoded as “X New Admin Email Address”, where X is the network name.

[cc lang=”php”]

Confirmation Link: [confirmation_link]

[/cc]

This notification can also use any of the [cc lang=”php” inline=”true”][new_admin_user_*][/cc] shortcodes in the message body only of this notification. These shortcodes will only output correctly if the new site admin email address matches that of an existing user within the network.

Site Admin Email Changed – For Old Site Admin
This notification is sent when the site admin email address has been changed and is sent to the old site admin email address.

This notification can also use any of the [cc lang=”php” inline=”true”][old_admin_user_*][/cc] and [cc lang=”php” inline=”true”][new_admin_user_*][/cc] shortcodes in the subject and message body of this notification. These shortcodes will only output correctly if the old and/or new site admin email address matches that of an existing user within the network.

New Site Activated – For User
This notification is sent when a user registers a new site.

You can use the following shortcodes in both the message body and subject of this notifications. Available shortcodes are:

[cc lang=”php”]

Activate Site Link: [activation_link]
Domain of the Site (if the multisite is on a subdomain): [domain]
Path of the Site (if the multisite is in a sub-directory): [path]
Site Title: [title]

[/cc]

New User Added to Site – For User
This notification is sent to the new user when a new user is created on a sub-site from Users > All Users > Add New User, or when an existing user is added to a site.
This notification will not trigger if the “Skip notification” checkbox is enabled.

This notification can only use two shortcodes in both the subject and message body of the notification. These are:

[cc lang=”php”]

Subsite Title: [subsite_title]
Activation Link: [activation_link]
User Login: [user_login]

[/cc]

New User Confirmed – For User
This notification is sent to the user when they confirm/activate their account.
This notification will not trigger if the “Skip notification” checkbox is enabled.

Due to a restriction within WordPress, it is possible to override the subject of this notification.

You can use shortcodes in the message body though. Available shortcodes for this are:

[cc lang=”php” inline=”true”]Password: [password][/cc]

This notification can also use any of the [cc lang=”php” inline=”true”][email_user_*][/cc] shortcodes in the message body only of this notification.

 

Additional Shortcodes

All notifications that can support shortcodes in a subject or message body can also use the Network Name shortcode – [cc lang=”php” inline=”true”][network_name][/cc].

 

Licensing Details

This add-on’s licensing works slightly different to that of other BNFW add-ons. The Multisite add-on only requires a license for the primary site on the network. As such, to activate the license and ensure automatic updates for this add-on, please do the following:

  1. Ensure BNFW and this add-on are installed and activated at the network level.
  2. Go to the primary site on the network and go to Notifications > Add-on Licenses.
  3. Add your license key for the Multisite add-on and activate as normal.

The license key field for the Multisite add-on on the Notifications > Add-on Licenses page will not show for any sub-sites on the network.

Naturally, if you run multiple Multisite networks, you’ll need a license for each network that you wish to use this add-on with.

All other BNFW add-ons are licensed normally – you’ll need an active license for each add-on for each sub-site of the network that you wish to use them on.

 

Questions?

Still have a question? Ask me a pre-sales question here and i’ll gladly help.