This guide explains how Branda simplifies white labeling, rebranding, maintenance pages, and even email. Use the Index on the left to quickly locate usage guidance on specific features.

If you haven’t installed Branda yet, then you should visit the Branda page where you can explore the plugin’s many features, download the free version, and where WPMU Dev members can install Branda directly to any connected site.

7.1 Dashboard

Link to chapter 1

The Branda Dashboard allows you to access every module from one screen.

Branda-dashboard

Branda’s modules are organized into five functional groups:

Take Advantage of Branda

If you’re on the lookout for more tips and tricks to make Branda your new best friend, look no further than our blog on how to Get the Most Out of Branda.

To access a specific module from the dashboard, locate the module’s functional group, and click the Edit Module link on the right. The module’s activation and configuration settings will appear, along with links to other modules within the same functional group. A status indicator next to each module will be blue if a module is active and clear if it is not.

Branda-frequently-used

Click the Manage All Modules button at the top of the Branda Dashboard screen to access a bulk action feature that allows you to activate or deactivate any or all modules from one screen.

Select All at the top of each column to select or deselect all the modules in that functional group, or click the boxes next to individual modules to select/deselect them. Click the Save Changes button to enact your changes.

Branda-modules-all

View Documentation

Click the View Documentation button to access this Branda user guide any time you need it.

Search

Use the search option to quickly locate individual modules from any of the five functional groups.

Branda-modules-search

7.2 Admin Area

Link to chapter 2

The Admin Area group includes modules that enable you to customize pretty much everything in the admin area of your site.

WANT A COMPREHENSIVE GUIDE?

Our blog on how to Completely Customize The WordPress Admin Area With Branda shows you just how easy it is to fully personalize your Admin Area with our Branda plugin.

7.2.1 Admin Bar

Link to chapter 2

The Admin Bar module allows you to customize the admin bar logo, to create custom menus, to show or hide menus based on user roles and to reorder the admin bar menus.

Rebrand Your WordPress Multisite

Are you interested in completely transforming your multisite network admin area? Check out our blog, Customize Your WordPress Multisite Admin Areas, to learn how to use Branda’s powerful tools on your multisite.

Click the Activate button to proceed.

Branda-adminbar-activate

LOGO

Replace the default WordPress logo in the admin bar with your own by clicking the Upload Image button and selecting an image from your media library or by uploading one from your computer. The new logo will appear in the toolbar on every page of the admin area and will link to the About WordPress menu.

Branda-adminbar-logo

TOOLBAR VISIBILITY

By default, the admin toolbar is visible only to logged-in users, but you can make your custom admin bar menus available to logged out users. The default WordPress menus, such as My Sites, Comments, Updates, etc., will not display to logged out users, but if you enable logged out visibility, your custom menus will. Any custom menu item that links to a site admin page will require users to log in before redirecting them to the intended page.

Select the user roles who should see the toolbar on the frontend, then click Save Changes.

Branda-toolbar-visibility

MENU ITEMS

Customize the Admin Bar menu by hiding menus, reordering them, or by adding your own custom menus. You can also choose what menus are visible to users based on their roles.

By default, all menus in the admin bar are in the “Show All” state, meaning all menus are visible to all users. You can hide a menu from all users, such as a default WordPress menu, or customize the menus available to each user. To do so, click the Hide Specific Items button.

Branda-menu-items-visibility

Visibility

Select the menus you wish to hide, and then select which user roles should not see the selected menus. Click the Save Changes button at the top of the module to save your settings.

Branda-menu-items-visibility-select

Custom Entries

You can create multiple custom menus and position them in the toolbar along with the WordPress menus, or remove the WordPress menus and display your menus only. You can also determine which users see which menus. So, if you wish, you can create a unique set of menus that only authors see, another set for admins and so on for each user type. Let’s walk through creating a custom menu.

Click the Show button and then click the Add Custom Item button.

Branda-add-custom-menu

General Tab

Title – You can enter text into the title field or add an image URL if you want the menu represented by an image instead.
Icon – You can select an icon to accompany your menu from more than 200 icons are available in the drop-down menu.

NOTE: It is recommended that you set an icon for each menu main title, because only the menu icon is visible on mobile devices.

Link To – Choose whether the menu will direct users to your network’s main site, the current site, the WP Admin Area, or apply a custom URL. You can also choose to have no link, as might be the case if the title is just a parent label for a list of submenu links.
Open link in – If the menu title is linked, choose whether that link will open in the same tab or in a new one.
Discard Changes – This button will clear all the fields in the General tab.
Update– Click the Update button to save your menu.

custom menu item

Submenu Tab

Use the Submenu tab to create a multi-level menu. Click the Add Item button, and then click the down arrow to open the options for your submenu item.

Title – Enter the navigation label you want to appear in the menu.
Open link in – Select whether the link will open in the same tab or a new one.
Link to – Choose where the link should direct users. If you choose Admin Page, enter a URL relative to your site’s admin URL. Choose Site Page to link to any page on your site. Choose External to link to another website.

Add Item – Click the +Add Item to add another submenu item. Repeat the steps above, and continue to add submenu items until your menu is complete.

Click the ✔ Add button to add the submenu items to the main menu title you created previously.

Branda-add-custom-menu-item-submenu

Visibility Tab

By default, custom menus are visible to all users. If you want to hide your custom menu from some user roles, uncheck those roles under the Visibility tab. Click the Show button if you want the menu to be visible on mobile devices (note this option only appears after you’ve initially saved the custom menu). Clicking the Cancel button will clear all selections.

Click the Add/Update button to save your visibility settings.

Branda-add-custom-menu-item-visibility

Reorder Menu Items
Organize the Admin Bar menus to suit your needs by clicking the Reorder Menus button. Click the Restore Default Order button to revert the toolbar menus to their original order.

Branda-reorder-menus

The toolbar menus agitate when the Reorder button is clicked. Drag the menus into your preferred order, and click the Save Changes button.

Branda-reorder-menus-toolbar

Custom CSS

Add custom CSS styles to the Admin Bar with this CSS customizer. Use the Admin Bar, Admin Bar Icon, and Menu Item selector buttons to isolate the aspect of the admin bar you wish to customize.

Branda-adminbar-custom-css

Improve page builder compatibility

Level-up your page builder integration with Branda by adding GET parameters. These parameters for your page builder will ensure that Branda does not overwrite the settings on those pages.

improve page builder compatability

7.2.3 Admin Menu

Link to chapter 2

The Admin Menu module allows you to fully customize the admin menu by user role or by custom user. You can add, hide and reorder the menu items as needed. You can also enable the Link Manager or the Dashboard link from the admin panel for users without a site (in WP Multisite).

Click Activate to proceed.

Branda-admin-menu-activate

Once activated, you’ll see this module contains a few sub-modules:

Branda-admin-menu

Custom Admin menu

The Custom Admin menu option enables you to fully customize the admin sidebar menu for selected user roles or even specific users.

Click the Customize button to pop open a modal with all its options.

custom admin menu options

Configure menu items

First, select whether you want to customize the menu for user roles or specific users in the dropdown menu. Note that any customizations you make here for specific users will override customizations made for the corresponding user roles. The available roles to configure are:

  • Super Admin (only for WordPress Multisites)
  • Administrator
  • Editor
  • Author
  • Contributor
  • Subscriber
  • Customer
  • Shop Manager

custom admin menu user roles

At the bottom of the modal are options to Apply your changes, or Discard all changes for the current editing session. Note that if you accidentally close the modal before clicking the Apply button, your edits will still be there when you re-open the modal as long as you haven’t navigated away from this Branda screen. So it’s a good idea to remember to click Apply as you go so you don’t lose your work.

Branda-admin-menu-discard-apply

To customize the menu for any user role, first click the user role you want in the top row. The list of menu items below will refresh and automatically populate with the admin menu items that user role has access to by default.

You can drag and drop the top-level menu items to re-order them any way you like, but you cannot move a top-level menu item into the submenu of another. If you need to move a top-level menu item into the submenu of another, you would need to manually re-create that as a new submenu item in the other one, then hide the original.

Hover your cursor over any menu item to reveal “Duplicate” and “Hide” options for that item, or click “Select All” or the checkbox in any menu item to reveal the same as bulk options above.

Branda-admin-menu-hide

Click the “Hide” option for a menu item to hide it from users with the selected role. You’ll then see an “Unhide” option appear on the menu item instead.

Click the “Duplicate” option to create an exact duplicate of the menu item, including its sub-menu. The “Duplicate” option can be very handy if you want to keep a hidden copy of the original menu item, and customize the sub-menu inside.

Click the down caret on the right to reveal additional options for any menu item.

Branda-admin-menu-item-settings

Under the Settings tab, you can customize the top-level menu item label, its CSS ID & classes, as well as its icon and where it links to.

Under the Submenu tab, you can drag and drop the submenu items to re-order them, as well as edit the same settings as the top-level menu item.

Note that while there is a “None” option for every menu item’s icon, it is recommended to use icons for all menu items as that’s all that appears on mobile devices.

To add your own custom top-level menu item, click the + Add Item button at the bottom of the modal, and adjust the settings in the same way as above.

Click the Submenu tab to add a submenu to your custom top-level menu item if you need one. You can also add custom sub-menu items to existing top-level menu items in the same way.

Branda-admin-menu-add-item

To edit the menu for a specific user, select Custom Users in the dropdown at the top of the modal. Then use the search field to find the user you want to edit the menu for. You’ll then see that user appear in the top row instead of user roles.

Customize the menu for that user in the same manner as above, and once again, remember that any customization you make for a user will override customizations made for that user’s role. In other words, you can set up a customized menu for a user role, then override that for specific users with that same role.

custom admin menu custom user

Remember to click the Apply button at the bottom of the modal to save your customizations.

Settings

The Settings tab allows you to further customize what your users can and can’t do by using the User Role Editor plugin.

custom admin menu settings

This option appears only in multisite and allows you to remove the Dashboard link from the admin for any users that do not have a subsite. This way, the only admin screen they can access is their Profile screen in the main site admin.

Branda-remove-dashboard-link

Branda allows you to restore the WordPress Links Manager that was removed from the admin menu with WordPress version 3.5. The links manager allows you to add, modify, or remove links without having to manually modify the HTML source code.

Click the Enable link manager button to re-enable the link manager. This also re-enables the blogroll widget under Appearance > Widgets that you can add to any widgetized area on your site to display your links.

Branda-enable-link-manager

When enabled, the link manager will once again be available on your site under the “Links” menu item in the admin menu for each site in your network. Click the Links menu item to view the options where you can create & manage your blogroll links.

Admin Tips

The Admin Tips option allows you to display custom messages at the top of any admin screen in your site or network.

Branda-enable-admin-tips

This option creates a new post type on your site that displays only in the admin area of your site: Tips. Once the option is enabled, you’ll see a new “Tips” menu item appear in the admin menu.

Create and edit your admin tips with the WYSIWYG editor just like any other post. In the Tips editor sidebar, you’ll see a metabox to customize where your admin tip should appear. Branda recognizes all plugin menus as well, and this section will give you options to enable your tips on the admin screens of any active plugin you have installed.

Branda-display-admin-tips

You can also set an optional expiry date for the tip so it will automatically disappear from view on that date.

Branda-admin-tips-display-date

7.2.4 Admin Message

Link to chapter 2

The Admin Message module allows you to display a custom message on all your admin pages. Click Activate to proceed.

Branda-enable-admin-message

Use the post -type editor to create your custom message. Click the Save Changes button at the top of the module to save your message.

Branda-admin-message-edit

Your custom message will appear at the top of every site’s admin page until it is removed.

Branda-admin-message

7.2.5 Color Schemes

Link to chapter 2

The Color Schemes module allows you to control which admin panel color schemes will be available to users and set the default color scheme for new users. Click Activate to proceed.

Activate-admin-color-schemes-in-Branda

Available Color Scheme

Branda provides several color schemes which can be selectively made available to users and one fully customizable color scheme with the default name “Branda”. Click the Save Changes button at the top of the module to save your changes. A brief guide to customizing the “Branda” color scheme is below.

Click the checkbox next to any color scheme you want to make available to users. At least one scheme is required, although multiple schemes can be selected.

Available-admin-color-schemes-in-Branda

Creating a custom scheme
Click the pencil icon in the Branda Scheme to pop open the Edit Color Scheme modal.

Customize-color-scheme-in-Branda

Edit Color Scheme
Use the Edit Color Scheme panel to create a custom color scheme for the admin sections of your main site and every site in your network.

Edit-Branda-color-scheme

When using the color pickers to customize your color scheme, click the color swatch on the left and choose a color from the palette, or enter a color hex code into the field provided. Click the Update button at the bottom of the modal to save your changes.

General – Use the color picker to the choose a background color for the Admin Area.

Color-picker-in-Branda-color-scheme

Links – Use the color picker to choose the colors used to highlight the links on your sites. The default color will display on all functional links except those specifically assigned a unique color. The Delete/Trash/Spam and the Inactive plugin color will display on the corresponding types of links. Under the Hover tab, you can choose the color of links being hovered by a cursor.

Edit-link-colors-in-branda-color-scheme

Forms – Use the color picker to choose the color displayed when checkbox and radio buttons are enabled.

Core UI – Use the color picker to choose the color of all CORE UI buttons and button text. Under the Hover tab, you can choose the color of buttons being hovered by a cursor.

List Tables – Customize the colors of certain table elements, including the View Switch icon, the post comment count, and the color of alternating rows. Under the Hover tab, you can choose the color displayed when these elements are hovered by a cursor.

Admin Menu – Customize the static and interactive colors of the Admin Menu. All links in the default state will display the Static color. Choose colors for the Hover, Current, Current Hover, and Focus options to customize how Admin Menu links behave when interacted with.

Admin Bar – Similar to the Admin Menu above, links in their default state will display the Static color. Choose colors for the Hover, Current, Current Hover, and Focus options to customize how Admin Bar links behave when interacted with.

Media Uploader – Use the color picker to choose the colors of the elements of the media uploader panel.

Click the Update button to save your custom palette.

Default Color Scheme

Use the drop-down menu to choose the default admin color scheme for new users. New users will be able to customize their admin color scheme whenever they wish unless you enable the Force Color Scheme option.

Default-color-scheme-in-Branda

Force Color Scheme

Use the drop-down menu to force use a color scheme for all users that only network administrators can change.

Force-default-color-scheme-in-Branda

7.2.6 Custom CSS

Link to chapter 2

The Custom CSS module allows you to add custom CSS to the header of every admin page.

Activate-Branda-custom-CSS

Use the CSS editor to edit the header stylesheet. Selector buttons are provided for some of the most common admin elements, but you can of course add any custom CSS here that would apply to the admin area only.

Edit-custom-admin-CSS-in-Branda

  • Bar – Applies custom CSS to the display properties of the admin bar
  • Content – Applies custom CSS to the dashboard container
  • Body – Applies custom CSS to elements within the dashboard container
  • Footer – Applies custom CSS to the footer displayed on the admin pages
  • Menu – Applies custom CSS to the main Admin Menu located on the left of all admin pages
  • Menu Wrap – Applies custom CSS to the main Admin Menu wrapper

Click the Save Changes button to save your custom CSS.

7.2.7 Customizer

Link to chapter 2

In multisite installs, the Additional CSS section is disabled by default in the Theme Customizer for all user roles except superadmins.

When activated, this module enables the Additional CSS section in the Customizer for subsite admin users.

Activate-Branda-customizer

7.2.8 Help Content

Link to chapter 2

The Help Content module allows you to change the existing help content shown by WordPress when you click the “Help” tab at the top-right of any admin screen. You can also add new help items, and/or add a sidebar to the help content. Click Activate to proceed.

Activate-branda-help-content

Help Items

Click the Add Help Item button to begin creating a custom help menu.

Branda-add-new-help-content

Create your custom help item in the post-like editor, add media if you wish, and click the Add button to save. Repeat the process to create multiple help items.

branda-edit-help-content

Menu items can be reordered after they are created by dragging and dropping the menu blocks.

branda-order-help-content

Help Sidebar

Add a sidebar within your custom help content with this editor. Enter the sidebar text and add media and links as desired. The sidebar will not appear if no content is added.

Branda-help-sidebar

Your custom help content can be accessed by clicking the Help drop-down menu in the top-right corner of every admin page.

Open-Branda-help-sidebar

Settings

In multisite installs, click the Hide new help panels in Network Admin area button to prevent your custom help items from appearing in the network admin.

Click the Keep the default help items button if you wish to merge your custom help menu with the default WordPress admin help menu, otherwise, the default menu items will not appear.

Branda-help-content-settings

7.3 Emails

Link to chapter 3

The Email Module will help you stop sending “text only” system emails from your website, and allows you to send SMTP emails, which greatly reduces your email rejection rate.

DID YOU KNOW?

WPMU DEV members are authorized up to 10 free email accounts that can be configured in minutes to display the member’s domain in the email address. See our Email Hosting product page for details.

7.3.1 From Headers

Link to chapter 3

Email From

The “Email From” settings determine the default email address for all of your site’s outgoing emails, as well as the sender name that appears in those emails. By default, WordPress uses the address and display name of the admin email you have entered in your site’s Settings > General.

To change that, enter the email address and sender name you prefer in the fields provided, and click the Save Changes button.

Branda-email-from-headers

Return-Path

The Return-Path is the email address where email notifications, such as undeliverable notices, will be sent. It may be the same address as the From Header, but you may wish notices sent to an email set up specifically to receive them. In that case, enter the email address in the field provided, and click the Save Changes button.

Branda-from-headers-return-path

7.3.2 Email Template

Link to chapter 3

This module enables you to create an HTML template that will be used to wrap every email sent from your site. Click the Activate button to proceed.

activate-branda-email-templates

Choose a template

The first time you activate the Email module, you will be prompted to choose an email template. Select a template, or select Start from Scratch if you want to build your own template, and then click Continue. You can change your template choice at any time by clicking the Choose a Template button.

Branda-select-email-template

HTML Editor

Use the HTML editor to customize your chosen email template or create one from scratch. You can use the variable buttons provided to insert dynamic data into your template.

Email Subject – This identifies the title of the email.
Message – This identifies the message content of the email.
From Name – This is the name that appears in the From field of your system emails.
From Email – This is the email address from which your system emails are sent.
Admin Email – This is the administrative email address to which you want email-related notifications sent.
Sidebar Title – If your email template includes a sidebar, this is the title you wish to display in that sidebar.
Blog URL – Presumably, this is the URL of the website sending the email, although you can enter any URL you wish.
Blog Name – The name of the sending blog or website.
Blog Description – The site description you want included in the email.
Date – The date appearing in the content of the email.
Time – The time appearing in the content of the email.

Branda-email-templates-editor

7.3.3 Registration Emails (Multisite Only)

Link to chapter 3

The MultiSite Registration Email module allows you to customize email notifications generated when new users and new sites are added to your network. Click Activate to proceed.

Activate-Branda-registration-emails

NOTE

You must enable user and/or site registration in Network Settings before you can create your custom email notifications. Attempting to do otherwise will trigger the error messages below. Both messages contain a link to your Network Settings. Once user and/or site registration are enabled, return to and refresh this page, and then you can begin configuring your custom email notifications. It is also recommended that you configure your SMTP credentials before sending emails.

Branda-registration-emails-new-blogs-disabled-alert
Branda-registration-emails-new-users-disabled-alert

In your network admin Settings > Network Settings, select any option at “Allow new registrations” except “Registration is disabled” according to your needs.

Network-admin-settings-registration

With new user and/or site registration enabled, you can now configure the Multisite Email Registration module.

Note the presence of PHP variables in the subject line and email body of each of the three emails available for customization: [%1$s] and %2$s and %s. While you can of course move them around in your custom emails, it is recommended to leave them in the emails as they are required for the following:

  • [%1$s] works in the subject line only and will be replaced by whatever you have set for the Network Title in your network settings.
  • %2$s works in the subject line only and will be replaced by the site name or username.
  • %s works in the email body only and will be replaced by the links needed for the user to activate their new site or username.

New Blog

To customize the email generated when a new blog is published, click the button enabling Customize new blog notification email. If you want, you can replace the word “Activate” with a custom subject line, but do not edit the php variables.

Likewise, you can change the text in the Email Body field to whatever you prefer, but do not editing the existing php variables.

Click Reset if you want to return the customization fields to their default states after saving any changes.

New-blog-email-in-Branda-registration-emails

User Sign-up

To customize the email generated when a new user signs up on your network, click the button enabling Customize new user sign-up email. If you want, replace the word “Activate” with a custom subject line. Do not edit the php variables.

Likewise, you can change the text in the Email Body field to whatever you prefer, but do not editing the existing php variables.

Click Reset if you want to return the customization fields to their default states after saving any changes.

New-user-email-in-Branda-registration-emails

Site Activation

To customize the email generated whenever a new site is registered on your network., click the button enabling Customize new site activation email. If you want, replace the words“New Site” with a custom subject line. Do not edit the php variables.

Likewise, you can change the text in the Email Body field to whatever you prefer, but do not editing the existing php variables.

Click Reset if you want to return the customization fields to their default states after saving any changes.

Site-activation-email-in-Branda-registration-emails

Click Save Changes at the top of the module to save your customizations.

7.3.4 SMTP

Link to chapter 3

The SMTP Module allows you to configure your email settings to support sending emails via a SMTP server. This will prevent your outgoing emails from going into the junk/spam folder of the recipients. Click Activate to proceed.

Activate SMTP in Branda

NOTE

You will need to gather some information from your email host before configuring the SMTP email module. This includes the host name of your mail server (for example: smtp.gmail.com), the encryption type (typically SSL), and your host server’s SMTP port.

You will also have to make changes to the settings of your webmail service (Gmail, G-Suite or Outlook.com) or client application (Outlook, Apple Mail) in order to send domain emails from another email account. For more info on that, see https://premium.wpmudev.org/blog/how-to-use-gmail-to-send-wordpress-emails/

From Headers

The “From Headers” settings determine the default email address and name for all of your site’s outgoing SMTP emails.

Enter the email address that emails should be sent from. This must be an email address associated with your domain. In other words, if your domain is somesite.com, you cannot send email from anothersite.com

Enter the name you want to appear on emails sent from your website into the “From name replacement” field. Be aware that the name entered here will override the from name entered for other plugins such as Contact Form. Click the Disable button if you wish to use the name entered in the “From Headers” module to apply to SMTP emails as well.

Branda-smtp-from-headers

SMTP Server

Host
Enter the host name of your mail server, choose the encryption for your mail server, and enter the port recommended by your mail server. For most servers, SSL or TLS is recommended.

Branda-smtp-server-settings

The above illustrates settings for using SMTP from Gmail. For more details on that, see the “Use the Gmail SMTP Server” section in this Google help article: https://support.google.com/a/answer/176600?hl=en

Click the Enable button if you want to authorize insecure and self-signed SSL certificates on your SMTP server, although this is not recommended.

Insecure-ssl-option-in-branda-smtp

SMTP Authentication

Click the Enable button to use SMTPAuth. SMTP authentication means that every email sent from your site will be identified with the username and password associated with that particular email account. This greatly reduces the risk that your emails will be rejected by the receiving email server, and makes it harder for spammers to use your account to send bulk email through your server, which can damage your site’s reputation.

Branda-smtp-authentication

Note that if you use Gmail SMTP and your Google account has 2-factor-authentication enabled, you’ll need to set up an app-specific password to use in the SMTP Authentication instead of your Gmail account password. For more info on setting that up, see https://support.google.com/mail/answer/185833

Note also that while you can use the SMTP Server and Authentication info from one domain on a different domain altogether, it is not recommended to do so as email clients would likely interpret that as spam and defeat the whole purpose of using SMTP.

Once you’ve finished configuring things, click the Send Test Email button at the top to send yourself a test email to ensure the setup is working as expected.

Send-test-email-in-Branda-SMTP

Additional configuration examples

If you don’t have a Gmail account, or don’t want to use it for SMTP, you can instead use SMTP settings from your host, or other services like Sendgrid or Mailgun.

Host/cPanel

To use the SMTP settings provided by your host, go to the Email Accounts section in your cPanel and click “Connect Devices” for the account you want to use. You’ll then see the Outgoing Server info you need in the “Mail Client Manual Settings” section.

cPanel-smtp-server-settings

Sendgrid

To use SMTP from your Sendgrid account, click on Email API > Integration Guide in the sidebar menu, then choose the “SMTP Relay” option. Enter a name for your API key and click “Create Key”. You’ll then see the info you need to enter in Branda in the “Configure your application” section.

Sendgrid-smtp-server-settings

Mailgun

To use SMTP from your Mailgun account, click on Sending > Domain Settings in the sidebar menu, then click the “SMTP Credentials” tab. Click “New SMTP User” at top-right and enter the username you want to create, then click “Create SMTP Credential”. You’ll then see the info you need to enter in Branda in the “SMTP Credentials” and “SMTP Settings” sections.

Mailgun-smtp-server-settings

7.3.5 Email Logs

Link to chapter 3

The Email Logs feature works hand-in-hand with SMTP to help you keep track of your email history. Click Activate to get started.

activate email logs

Ensure that you have the SMTP module active so that you can start storing email logs.

enable SMTP for email logs

If you haven’t sent any emails yet, this area will be void of any email history but it will populate as soon as there are logs to show. You can refer to the SMTP section in this document for more information on how to set up your SMTP.

Once you have accumulated some emails, you will see them appear in your log with the following key details about the emails.

  • Recipient – To whom the email was sent.
  • Sent at – The date and time of the email.
  • Subject – The subject of the email.

email logs

Click on the row of the email to expand the information and view details like:

  • From Name – The name that you set under From Headers in the SMTP tab.
  • From Email – The email address from which the email was sent.

email dropdown information

Click the Delete button to remove that email log or you can click on Export to export the email details as a .csv file.

If you’re wanting to manage your emails in chunks, you can use the bulk action tool to do this. Simply click on the checkbox next to each email you want to action, click on Bulk actions, select the action that you want and click Apply.

apply bulk actions

Wanting to view your past emails in a more manageable way? Achieve this in a few clicks with the Filter feature. Click on the filter icon and choose your criteria based on:

  • Email Date Range
  • From Email
  • Recipient
  • Keyword
  • Sort By
  • Sort Order

filter email logs

After you have set up your filter criteria, click Apply to action the filters. You can also click Clear Filters to remove all of your criteria.

To access the email logs settings, click the Settings button in the top right-hand corner. This will open a module that allows you to export all of your email details as a .csv file by clicking Export, as well as setting the limit for your clear log. Set the Log limit to cap the number of logs that will be kept, after which they will be cleared. If you set the Log limit to 0, your entire log history will be kept.

log settings

To disable the email logs feature, click on the Deactivate button in the top right-hand corner.

7.4 Front End

Link to chapter 4

The Front End modules enable you to customize every bit of the front-end of your WordPress website to match your website’s theme.

7.4.1 Author Box

Link to chapter 4

The Author Box module adds a responsive author box, inline or as a widget, at the end of your posts, showing the author’s name, biography, gravatar, post history, and social network profiles. Click Activate to proceed.

Activate-Branda-author-box

Configure

Author Box Widget
From the Admin Menu, go to the WordPress widget manager (Appearance > Widgets), and locate the Author Box widget. Drag and drop it into any sidebar or widgetized area of your theme.

Branda-author-box-widget

Inline Content
By default, the Author Box module allows you to display the author box as both an inline element or as a widget. Click the Disable button if you want to use the widget author box only.

Branda-inline-author-box

Visibility
Select the post types where the author box should display. This option will affect the visibility of the author box widget as well as inline author box.

Branda-author-box-visibility

Author Profile

Social Accounts
Click the arrow next to Social Accounts and then click the Add Accounts button, to reveal the Add Social Accounts menu.

Add-social-accounts-branda-author-box

From the menu of social networking platforms, select the social networking sites you want to allow authors to include in their profiles, and click Add Accounts to save your changes. You can delete added accounts using the trash icon to the right of each social network.

Branda-author-box-social-accounts

Each account you select here will add a corresponding field to a “Social Media Profiles” section in every user profile where each user or site admin can add/edit the social profile URLs.

Branda-author-box-profile-social-accounts

Depending on your configuration above, your custom Author Box will appear in your widget and/or in posts and pages and will include a gravatar, bio, article count, and social media links.

Branda-author-box

Design

Click the arrow next to any element to reveal the customization options for that element.

Branda-author-box-design

Name and Bio

  • Author’s Name – Click Show to display the author’s name in the author box.
  • Link Name – Click Enable to link the author’s name to the author archive.
  • Number of posts – Click Show to display the number of posts written by the author in parentheses next to the author’s name.
  • Author bio – Click Show to display the author’s bio in the author box.

Branda-author-box-name-bio

Avatar

  • Visibility – Click Show to display the author’s avatar in the author box.
  • Size – Adjust the size of the avatar by entering the preferred size, in pixels, into the field.
  • Corner radius – Adjust the roundness of the avatar’s container by entering the desired radius, in pixels, into the field. The lower the number, the sharper the corner.
  • Border Thickness – Adjust the thickness of the line surrounding the avatar by entering the desired size, in pixels, into the field.
  • Border Style – Click the arrow to reveal a drop-down menu from which you can choose the style of the line surrounding the avatar. Adjust the color of the border in the Color Scheme menu.

Branda-author-box-avatar

Latest Entries

  • Visibility – Click the Show button to display a list of the author’s most recent posts.
  • Entries Type – Click All if you want the list to include anything contributed by this author. Click Same as the current post type to filter the items included in the list by post type. With this feature enabled, when the author box accompanies a post, only posts will appear in the list, but not media, such as videos, etc. Conversely, when the author box accompanies a video, only videos contributed by the same author will appear in the list, but not other types of posts.
  • Number of entries – Enter the number of items you want to appear in the list.
  • Open link – Click the Same Tab if you want the entry list item, when clicked, to open the author archive in the same tab, and click New Tab if you want the archive to open in a new tab.
  • Entries title – Enter the title you want to appear above the list. Leave the field blank if you don’t want a title.

Branda-author-box-latest-entries

Social Accounts

  • Show – Click Show to display links to the author’s social network accounts.
  • Open link – Click New if you want the author’s social accounts to open in a new tab, or click The Same if you want them to open in the same tab.
  • Icon Style – Click Colors if you want the social account icons to display in color, and click Monochrome if you want them to display in black and white.
  • Position – Click Bottom, Top or Under avatar to indicate where you want the social icons to appear within the author box.

Branda-author-box-social-accounts-design

Container
Adjust the corner radius, border thickness and border style of the author box.

Branda-author-box-container

Colors

Click the arrow next to any element to reveal the customization options for that element.

Branda-author-box-colors

Use the color pickers to adjust the available color combinations for each element. Click Reset at the bottom of this section to return the color combinations to their default state.

Branda-author-box-colors-name-bio

  • Name and Bio – Click the color swatches to open the color pickers, and choose the color you want applied to the author’s name and bio text. You can also enter the Hex Color Code in the field provided. Click Select to confirm your choice.
  • Avatar – Click the color swatches to open the color picker, and choose the color you want applied to the border surrounding the avatar. You can also enter the Hex Color Code in the field provided. Click Select to confirm your choice.
  • Latest Entries – Click the color swatches to open the color picker, and choose the color you want applied to the title of the Latest Entries list, and then do the same for the text color of the entries on the list. You can also enter the Hex Color Code in the fields provided. Click Select to confirm your choice.
  • Social Accounts – Click the color swatches to open the color picker, and choose the color you want applied to the title of the background of the social accounts container. If you chose to display the social account icons in monochrome, you can apply a single color to all those icons with the monochrome color picker. You can also enter the Hex Color Code in the fields provided. Click Select to confirm your choice.
  • Container – Click the color swatches to open the color picker, and choose the color you want applied to the title of the author box border and background. You can also enter the Hex Color Code in the fields provided. Click Select to confirm your choice.

Custom CSS

For more advanced customization options use custom CSS. This will be added to the header of every Login page. You can use the preset element identifiers to ensure your customizations are properly applied.

  • List – Customize the author post list if included.
  • Author Name – Customize how the author name displays in the author box.
  • Box Content – Customize the author box container.
  • Avatar – Customize the author’s avatar.
  • Social Media – Customize the container in which the social account icons display.

Branda-author-box-custom-css

7.4.2 Blog Description (Multisite Only)

Link to chapter 4

This module allows new bloggers to set their site tagline when they create a new blog in your multisite. Click Activate to proceed.

Activate-Branda-blog-description

There are no options for this module. Once activated, it simply adds a new field to your signup form where users can brand their site with their own tagline during the signup process.

Branda-blog-description-in-signup-form

7.4.4 DB Error Page

Link to chapter 4

The Database Error Page module allows you to customize both the content of your DB Error message and your site’s behavior when a visitor encounters an error. Click Activate to proceed.

Activate-Branda-DB-error-page

Copy Settings

This feature allows you to copy the logo and/or background images used elsewhere in Branda to this DB Error Page. Click the Copy Settings at top-right, then select from the menu those items you wish to apply to your DB Error Page. Click Copy to add the elements to this page.

copy-settings-in-Branda-db-error-page

Preview

By Default, the preview feature is not available until you create your DB Error Page. To preview the page, create it, and save your changes, then click the preview button.

preview-Branda-db-error-page

Content

Logo & Background
Click the arrow next to the Logo & Background option, then use the upload image tools to add a logo and/or a background image. Enter a URL into the field provided if you want the logo, when clicked, to redirect visitors to another page. Add Alt Text is you so desire.

Branda-db-error-page-content-logo

NOTE: You can add multiple background images to your DB error page that display in a slideshow. Customize the behavior of multi-image backgrounds in the Design section.

Custom Error Message
Enter a custom title in the field provided, if you wish, and create your custom error message in the editor.

Branda-DB-error-page-message

Social Accounts
To add your social network sites to your custom error message, click the arrow next to Social Accounts, then click Add Accounts. From the menu of social networking sites, select the accounts you wish to add, and click Add Accounts.

Branda-db-error-page-social-accounts

Unlike the Author Box module above, adding social accounts here does not add a field in your WordPress user profile. Each added account must be configured here as they only appear on your custom DB error page. You can delete added accounts using the delete icon to the right of each social network.

Branda-db-error-page-social-new-account

Design
Click the arrow to the right of the message element you wish to modify to reveal the design customization options for that element. Click the Save Changes button at the top of the module to preserve your modifications or Reset to return the elements to their default settings.

Branda-db-error-page-design

Logo

  • Width – Enter the width you wish the logo to be displayed.
  • Opacity – Enter the the desired opacity of the logo.
  • Position – Select whether you want the logo to appear in the left or right corner or centered on the page.
  • Margin – Enter the preferred page margins.
  • Corner radius – Adjust the roundness of the avatar’s container by entering the desired radius, in pixels, into the field. The lower the number, the sharper the corner.

Branda-db-error-page-logo-design

Background

  • Multiple Images Mode – This mode only applies if you uploaded multiple background images. Select Slideshow if you wish the images to display and transition in a classic slideshow, and select Random if you want the images to display and transition in random order.
  • Background crop – You can crop the background image here to a percentage of the viewport size, or to fixed dimensions.
  • Background attachment – Select whether the background image should be fixed in the viewport or scroll with the content.
  • Background Size – Choose whether and how the background image is resized to fit within the page container.
  • Horizontal background position – Choose whether the image should be oriented on the left, right or centered on the page.
  • Vertical background position – Choose whether the image will be oriented on the top, bottom or centered on the page.

Branda-db-error-page-background-design

Error Message
Choose a flush left, flush right or centered justification for the error page message.

Branda-db-error-page-message-design

Social Accounts
Show – Select Show to display the social network accounts you added in the Content section.
Open Link – Select New if you want the social network links to open in a new tab, or select The same if you want them to open in the current tab.
Icon Style – Select Color if you want the social network icons to display in color, or select Monochrome if you want them to display in black and white.

Branda-db-error-page-social-accounts-design

Content Wrapper
Enter the width of the page’s main content wrapper. All other settings will be applied relative to and within this wrapper. Use the Corner Radius field to adjust the roundness of the avatar’s container by entering the desired radius, in pixels, into the field. The lower the number, the sharper the corner.

Branda-db-error-page-wrapper-design

Reset
The Reset button will return all design settings to their default state.

Colors

Click the arrow to the right of the content area you wish to modify to reveal the color picker for that area.

Branda-db-error-page-colors

Logo and Background
Click the color swatches to open the color pickers, and choose the colors you want applied to the logo and background. You can also enter the Hex Color Code in the field provided. Click Select to confirm your choice.

Branda-db-error-page-logo-colors

Error Message
Click the color swatches to open the color pickers, and choose the colors you want applied to the title and error message text. You can also enter the Hex Color Code in the field provided.

Content Wrapper
Click the color swatch to open the color picker, and choose the color want applied to the background of the DB Error Page. You can also enter the Hex Color Code in the field provided.

Custom CSS

Add custom CSS to the DB Error Page for more advanced customization. Custom CSS will override customizations made elsewhere in this module. Preset identifier and selector buttons have been provided to simplify CSS customization.

  • Overall – Customize the page background.
  • Page – Customize the area surrounding the Error Message content. This area is where your custom logo will appear, if one has been added.
  • Content – Customize the Error Message container, including the message itself, if you wish.
  • Social Media – Customize the Social Accounts container.
  • Logo – Customize the logo container. Typically, a custom logo fills the container, but with custom CSS you can create a larger container and customize the area around the logo.

Branda-db-error-page-custom-css

Behaviour

Send alert email
Click Enable and enter an email address into the field provided if you want to be notified by email each time a DB error is triggered.

Branda-db-error-page-behavior

7.4.5 Document

Link to chapter 4

The Document module allows you to add custom content that appears at the beginning and/or the end of content on every page or post and to modify the appearance and behavior of image galleries on your site. Click Activate to proceed.

Activate-Branda-document-module

Custom Entry Content (Before and/or After)

Click the arrow to the right of the Before and After content options, and click the Enable button to open the editor. Create the custom content you wish to appear before and/or after your page content, and click the Save Changes button.

entry-content-in-Branda-document

Your Before and After Content might look something like this.

Password Protected

Change the title appearance, message and password form labels for password-protected content.

Title
Click the arrow to the right of the Title option to reveal options for the page title of password-protected content.

  • Default – Preserves the default content title format.
  • Clear – Removes the default “Protected” message from the content title.
  • Custom – Enables you to customize the title format.

Branda-document-password-protected-title

Form
Click the arrow to the right of the Form option to reveal options for the password entry form that appears on password-protected content.

  • Default – Preserves the format of the password entry form.
  • Custom – Enables you to customize the message, password field title and button text.

Branda-document-password-protected-form

Shortcode (Gallery)

This feature allows you to standardize the image gallery shortcode for every site in your network. These settings will override any shortcode created by local site admins.

Branda-document-shortcode-options

Order
Open the Order settings panel by clicking the arrow to the right. These settings will affect how image gallery thumbnails are displayed.

Sort by

  • Do not change – Image gallery thumbnails will be sorted based on the settings applied by local site admins.
  • Images order set in gallery tab – Sorts images using the default WordPress gallery setting.
  • Title – Sorts gallery images alphanumerically by title.
  • Date/Time – Sorts gallery images by the time and date stamp.
  • Randomly – Gallery images display in random order.
  • ID of Image – Sorts images using their Image ID numbers.

Sort Order

  • Do not change – Image gallery thumbnails will be ordered based on the settings applied by local site admins.
  • Ascendant – Image gallery thumbnails are displayed in ascendant order. This is the default WordPress setting.
  • Descendant – Image gallery thumbnails are displayed in descendant order.

Branda-document-shortcode-order

Design
Enter the number of columns in which images will be displayed, and choose the size of those images. Note that in single site installs, any image thumbnail sizes created by your theme or active plugins will also appear here.

  • Do not change – Displays images in the sizes set by local site admins.
  • Thumbnail – 150px square. This is the default WordPress setting for gallery images.
  • Medium – 300px square
  • Large – 1024px square
  • Full – Images appear at the size they were when uploaded.

Branda-document-shortcode-design

Content
Here, you can set the default for where image thumbnails in galleries should link to.

  • Do not change – Uses the link set by local site admins.
  • Attachment page (WP default) – Links to the attachment’s permalink
  • Link directly to image file – Will open the image at the File URL as shown in the media library.
  • No link – Will disable all links in gallery images.

Branda-document-shortcode-content-options

HTML
Click the arrow to the right of the HTML option to customize the tags used to enclose your gallery images, thumbnails and captions. This changes how images are displayed and whether they are accompanied with icons and captions. The default WordPress tags are:

  • dl – itemtag
  • dt – icontag
  • dd – captiontag

Branda-document-shortcode-html

7.4.7 Header Content

Link to chapter 4

The Header Content module allows you to place custom headers on every page of your site or network. Click Activate to proceed.

Branda-header-content-activate

Configuration of the options for this module is identical to the Footer Content module. Please see the instructions detailed above.

7.4.8 Login Screen

Link to chapter 4

The Login Screen module allows you to customize the default login screen using a WPMU DEV template or from scratch. Click Activate to proceed.

Recommended Reading

Branda enables you to brand every inch of your site and the login screen is just one of the many areas you can customize. For a quick guide to the login screen tool, read our blog on how to Impress Clients With a Custom Login Page.

Activate-Branda-login-screen

Copy Settings

This feature allows you to copy the logo and/or background images used elsewhere in Branda to your Login Screen. Click the Copy Settings at top-right, then select from the menu those items you wish to apply to your Login Screen. Click Copy to add the elements to this module.

Branda-login-screen-copy-settings

Login Screen Template

Begin by clicking Choose a Template to pop open the template selection modal.

Branda-login-screen-template

Select either a pre-built template or the Start from scratch option, and click Continue to save your choice.

Choose-Branda-login-screen-template

Then use the Content, Design and Color panels below to customize any element from the selected pre-built template or to build your login screen from scratch. Click the arrow next to any item to access that item’s customization options.

Content

These options enable you to adjust the default content of the login screen.

Language
If you have set any language other than the WordPress default in your admin’s Settings > General > Site Language option, you will be able to select the default language for your login screen here.

Branda-login-screen-language

Logo and Background
Use the upload image tool to add a logo and/or a background image. Enter a URL into the field provided if you want the logo, when clicked, to redirect visitors to another page. Add alt text to assist screen readers and allow search engines to better crawl and rank your website.

  • Logo visibility – Select whether to show or hide your logo on the login screen.
  • Logo – Click the Upload Image button to upload a custom image for your logo.
  • URL – Enter the URL users should be directed to if they click your logo. If left blank, the logo will link to the login page by default.
  • Alt Text – Add alt text to assist screen readers and allow search engines to better crawl and rank your website.
  • Background image – Click the Upload Image button to upload one or more images for your login screen background. If multiple images are uploaded, you can create a slide-show in the design section.

Branda-login-screen-logo

Message
If desired, you can enter a custom message that will display on your login screen between the logo and the login form.

Branda-login-screen-message

Form
Customize the login form displayed within your login screen using the form options. Enter custom labels for your login screen fields and button, choose whether to add a Remember Me option, and even whether to add a background image to the screen’s login fields.

  • Username input label – Customize the label for the username input field.
  • Password input label – Customize the label for the password input field.
  • Login button text – Customize the text that appears on the login button.
  • “Remember Me” checkbox – Choose to show or hide the Remember Me checkbox, and whether it should be checked or unchecked by default.
  • Password field on register screen – Choose to show or hide the password input field on your register or signup screen.
  • Background image – Optionally upload a background image that will appear in the form, behind the input fields.

Branda-login-screen-form-options

Error Message
Use the Error Message options to customize the text that will display when a user enters incorrect text into a field or fails to enter anything at all.

  • Empty username – Customize the error message that appears if the username field is empty, or leave it at the default message.
  • Invalid username – Customize the message that appears if the username entered is not in a valid format. You can use the WP_LOSTPASSWORD_URL placeholder in this field; it will be replaced by the actual URL to your lost-password form. See this article for more on username sanitization in WordPress: https://codex.wordpress.org/Function_Reference/sanitize_user
  • Empty password – Customize the message that appears if the password field is left blank.
  • Invalid password – Customize the message that appears if the password entered is incorrect for the username entered above. You can use the WP_LOSTPASSWORD_URL placeholder in this field as well.

Branda-login-screen-error-messages

Links Below Form
The Links Below Form options simply allow you choose to display or hide the register & lost password links, “Back to” link, and whether to provide a link to your site’s privacy policy.

Branda-login-screen-link-options

Login Screen Design

Use the Design options to adjust the appearance of various elements such as Logo, Background & Form as well as the Error Messages displayed when users interact with your login screen.

Logo
The Logo options allow you to adjust the position, width, height, and margins of your logo and the look of its container.

  • Width – The logo width set here should ideally be smaller than the width of the form itself (default width is 320px). You can adjust the form & canvas widths below.
  • Opacity – Adjust the logo opacity if you want it to be a bit transparent and let the login screen background show through.
  • Position – Align the logo to the left, right or center.
  • Margin – Adjust the margins if needed using px, percentage, em or rem values.
  • Corner Radius – Adjust the corner radius to give your logo rounded corners.

Branda-login-screen-logo-design

Background
Background options allow you to adjust the design and behavior of your login screen’s background images. You can create a slideshow of multiple background images, and adjust those images’ size and position.

  • Multiple images mode – If you have uploaded multiple images for your login screen background in the Content settings above, you can choose to show them either as a continuous slideshow, or show only one image at random each time a user accesses the login screen.
  • Background crop – Use these options to crop the background image(s) if desired to change the height, width or both.
  • Background attachment – Set the background to remain fixed on the screen regardless of the length of the page contents, or allow it to scroll with the contents.
  • Background size – Select Cover to ensure images fill the screen even if one of the dimensions must be cut off a bit; select Contain to ensure images display fully even if that means blank areas top & bottom or on the sides; select Auto to display images at their original dimensions; select Length to set images to a fixed percentage of screen size.
  • Horizontal background position – Choose to position images to the left, right or centered, or set a custom percentage of screen width as the offset from the left side of the screen.
  • Vertical background position – Choose to position images at top, bottom or vertical center, or set a custom percentage of screen height as the offset from the top of the screen.

Branda-login-screen-background-design

Message
This option simply enables you to select either of the two default WordPress message styles: Inform (blue border) or Success (green border).

Branda-login-screen-message-design

Form
The Form options allow you to customize the look of the login form container by adjusting its border, margins, button style, and the fit of the background image if you chose to add one.

  • Style – Either leave this at the default flat style, or select shadowed box, and set the box-shadow options.
  • Corner Radius – Adjust the corner radius if you want the form to have rounded corners.
  • Padding – Adjust the padding values to give more room between the form fields and the form border.
  • Margin – Adjust the margin values to give more room outside the form.

Branda-login-screen-form-design options

  • Border – Adjust the form border thickness and style.
  • Button – Select either flat or shadowed style for the button and button text.
  • Image Fitting – If you have added a background image for the form in the Content settings above, you can adjust its fit properties here (same as for the Background image design above).

Branda-login-screen-form-design options

Error Messages
This option simply enables you to adjust the opacity of the error messages if desired.

Branda-login-screen-design-error-messages

Links Below Form
This option enables you to adjust the alignment of the links that appear beneath the form (register, lost password, return to).

Branda-login-screen-link-design

Form Canvas
The Form Canvas is the element that contains the login form itself. These options allow you to customize the look of the login form canvas by adjusting its position, width, height, padding, and margins.

  • Position – Adjust the position of the form canvas to the left or right of the screen, or leave it at the default (center).
  • Width – Adjust the width of the canvas using pixel, percentage, em or rem values.
  • Height – The Default option will ensure the canvas height self-adjusts to contain the login form; the Device Height option will ensure the canvas displays at the ful height of the device viewport.
  • Padding – Adjust the canvas padding using pixel, percentage, em or rem values.
  • Margin – Adjust the canvas margin using pixel, percentage, em or rem values.

Branda-login-screen-form-canvas-design

Form Container
The Form Container options enable you to adjust the default width and padding of the login form itself.

  • Width – Adjust the width of the form using pixel, percentage, em or rem values.
  • Padding – Adjust the padding uing pixel, percentage, em or rem values.

Form-container-design-in-Branda-login-screen

Colors

Use the color pickers to modify the default colors for every element of your login screen to better match your brand.

Background
This option allows you to set the main background color for the login screen itself.

Branda-login-screen-background-color

Form
Customize the colors for each state (Default, Active, Focus, Hover) of every element of your login form.

  • Input label – Customize the color of the form field labels like username & password.
  • Input color – Customize the color of the text the user inputs into the fields.
  • Input border – Customize the color of the field borders.
  • Input background – Customize the input field background color.
  • Button label – Customize the color of the text on the login button.

Branda-login-screen-form-colors-a

  • Button border – Customize the color of the login button border.
  • Button background – Customize the color of the login button background.
  • Form background – Customize the background color of your login form.
  • Form border – Customize the color of the login form border.
  • Form box shadow – If you have selected the Shadowed Box option in the Design section above, you can customize the color of the box shadow for your login form here.
  • Form container background – Customize the background color of the form container (that’s the element that contains the form itself, the logo & optional message at top, as well as the links beneath the form).

Branda-login-screen-form-colors-b

Error Messages
Customize the colors for each state (Default, Active, Focus, Hover) of the error messages that may display in your login form when users interact with it.

  • Background – Customize the background color of any error message that appears in your login form.
  • Border – Customize the border color of error messages.
  • Text – Customize the text color of the error messages.
  • Link – Customize the link color of the error messages.

Branda-login-screen-message-colors

Links Below Form
Customize the colors for each state (Default, Active, Focus, Hover) of the links that appear beneath your login form.

  • “Register | Lost your password?” links – Customize the colors of the Register | Lost your password? links.
  • “Back to Website” link – Customize the colors of the Back to Website link.
  • Privacy Policy – Customize the colors of the Privacy Policy link.

Branda-login-screen-link-colors

Form Canvas
This option enables you to change the background color of the form canvas element.

Branda-login-screen-canvas-colors

Login Screen Redirection

Enter the URLs redirecting users following a successful login or log out.

  • Login – Choose either to leave this at the default, or enter a custom URL where users should be redirected after logging in.
  • Logout – Choose either to leave this at the default, or enter a custom URL where users should be redirected after logging out.

Branda-login-screen-redirects

Login Screen Custom CSS

Use the CSS editor to achieve advanced customization options. Your custom CSS will be added to the header of every Login page. Selector buttons are provided for some of the most common admin elements, but you can of course add any custom CSS here that would apply to the login screen only.

  • Container – Applies CSS to the canvas element.
  • Logo – Applies CSS to the logo container.
  • Form Wrapper – Applies CSS to the form container.
  • Form – Applies CSS to the form element itself.

Branda-login-screen-custom-css

7.4.9 Signup Screen

Link to chapter 4

The Signup Screen module allows you to restrict user and blog registrations to the users with a specific signup code. Click Activate to proceed.

Activate-Branda-signup-screen

User Registration
Select the With Signup Code option to require users to obtain and enter a code before registering with your site. Select Anyone if you do not wish to requires codes.

Signup Codes – Enter the code the user needs to input to successfully register, select the user role to be assigned to new users registering with that code, and check the Case Sensitive box if uppercase/lowercase characters in the code must be an exact match.
Field Description – Customize the help text that appears beneath the signup code field.
Error Message – Customize the error message that appears if the code entered does not match any valid codes you have set up.

To create additional codes for additional user roles, click the + ADD SIGNUP CODE button.

Branda-signup-screen-signup-code-for-user-registration

Blog Registration (Multisite Only)
Select the With Signup Code option to require users to obtain and enter a code before creating a blog in your multisite. Select Anyone if you do not wish to requires codes.

The options for this section of this module are identical to the User Registration above, with the exception of the User Role option as there is no need for that when creating a blog.

7.4.10 Site Status Pages (Multisite Only)

Link to chapter 4

The Site Status Pages module applies to multisite networks only. Use the module to create a default error page to display when network sites are deleted, archived, have become inactive or spammed. Click Activate to proceed.

Activate-Branda-status-pages-module

Copy Settings

To ensure thematic consistency, you can copy the logo and/or background images from other pages you’ve created and apply them to your error pages. Click the Copy Settings button, then select from the menu those items you wish to apply to your the page. Click the Copy button to complete the copy process.

Branda-status-pages-copy-settings

Modes

Suspended, Archived or Deleted Pages
Click the Enable/Disable button beneath the Suspended/Archived and/or Deleted labels to apply or remove a custom error page from sites which have been suspended, archived or deleted from your network.

Branda-status-pages-modes

Preview

Click either button here to view a preview of your Suspended/Archived or Deleted error pages. The preview will update every time you save your changes.

Branda-status-pages-preview

Content

Adjust the content of your site error pages by adding a logo, background image, custom messages, and links to social accounts.

Logo & Background

  • Logo visibility – If you select to show a logo on your site error pages, use the image uploader to add a custom logo, add the URL of the page to which visitors will be redirected when the logo is clicked and add the desired Alt Text to assist web readers and search engines to crawl your site.
  • Background image – Use the image uploader to add a custom background image. You can add multiple background images and create a slideshow using the Design panel below.

Branda-status-pages-logo

Error Message
Click the arrow next to “Error Message”, and use the post-type editor to create your custom messages for archived/suspended or deleted sites.

Branda-status-pages-messages

Social Accounts
To add social network sites to your default site status page, click the arrow next to “Social Accounts”, and then click the Add Accounts button. From the menu of social networking sites, select the accounts you wish to add, and click Add Accounts. You can delete added accounts using the trash icon to the right of each social network.

The options here are identical to the Social Accounts options in the DB Error Screen module above.

Social-accounts-in-Branda-status-pages

Design

The Design panel allows you to tweak the design of elements on your default status pages, such as adjusting the size and position of elements and creating a slideshow of background images.

Logo
The options here are identical to the Logo options in the DB Error Screen module above.

Branda-status-pages-logo-design

Background
The options here are identical to the Background options in the DB Error Screen module above.

Branda-status-pages-background-design

Error Message
Choose a flush left, flush right or centered justification for the error page message.

Branda-status-pages-message-design

Social Accounts
The options here are identical to the Social Accounts options in the DB Error Screen module above.

Branda-status-pages-social-accounts-design
Click the arrow next to “Social Accounts” to choose whether social icons, when clicked, open in the current tab or in a new one. You can also choose whether the icons will be monochrome or color.

Content Wrapper
Enter the width of the page’s main content wrapper. All other settings will be applied relative to and within this wrapper. Use the Corner Radius field to adjust the roundness of the avatar’s container by entering the desired radius, in pixels, into the field. The lower the number, the sharper the corner.

Branda-status-pages-wrapper-design

Reset
The Reset button will return all design settings to their default state.

Color settings

Logo and Background
Click the color swatches to open the color pickers, and choose the colors you want applied to the logo and background. You can also enter the Hex Color Code in the field provided. Click Select to confirm your choice.

Branda-status-pages-logo-colors

Error Message
Click the color swatches to open the color pickers, and choose the colors you want applied to the title and error message text. You can also enter the Hex Color Code in the field provided.

Content Wrapper
Click the color swatch to open the color picker, and choose the color want applied to the background of the DB Error Page. You can also enter the Hex Color Code in the field provided.

Custom CSS
Use the CSS editor to apply advanced customization to your default status page. The preset identifier and selector buttons here are identical to the Custom CSS options in the DB Error Screen module above.

Branda-status-pages-css

7.5 Utilities

Link to chapter 5

Branda Utilities modules allow you to control comments, blacklist or whitelist IPs, add tracking codes, override image upload filesize limits, and brand any site within your network with your own favicon. The Website Mode module allows you to create custom Coming Soon and Maintenance pages.

7.5.1 Comments Control

Link to chapter 5

The Comments Control module allows you to disable the comments on posts, pages or on your entire website. You can also whitelist IPs for which comments will not be throttled, or blacklist IPs to disable commenting globally from them. Click Activate to proceed.

Activate-Branda-comments-control

Comments

  • Post Type – By default, comments are enabled throughout the site for all post types. To disable comments globally, click the Disable button, and then click the All button. To disable comments by post type, Click the Certain Post Types button to access the list of post types, then select the post types for which you wish to disable comments.
  • Disable comments for – To blacklist an IP, click IP Blacklist, and enter the IP address into the blacklist field, one IP per line. Both IPv4 and IPv6 are supported.

Comments-options-Branda-comments-control

IP Whitelist
To whitelist an IP, enter the IP address into the whitelist field, one IP per line. Both IPv4 and IPv6 are supported.

Branda-comments-control-whitelist

7.5.2 Images

Link to chapter 5

The Images module allows you to override the favicon defined on individual sites in your network, replacing it with a favicon of your choosing and also to override the default image filesize limit for some users. Click Activate to proceed.

Recommended Reading

Our blog post, How To Ace Google’s Image Page Speed Recommendations With Smush, focuses on Smush features that directly impact your Google Page Speed score.

Activate-Branda-images-module

Favicon

If you wish to override the favicon defined in the WordPress customizer, use the image uploader to add the preferred favicon, and then click the Override button. Click the X to the right of the image if you want to change or delete the uploaded image.

Branda-images-favicon

Multisite Favicons (Multisite only)

Use the Main Site image uploader to add a favicon for your main site. To use that same favicon on all the subsites in your network, click the Main Site’s Favicon button beneath the Subsites label.

Branda-images-multisite-favicon

To add custom favicons for each site, click the Custom button, and type the name of the subsite into the field provided. Click the Add button, and use the image uploader to add a custom favicon for that site.

Branda-images-multisite-subsite-favicon

In this way, you can add a custom favicon for each site in your network. Delete a favicon by clicking the trash symbol on the right.

Image Filesize Limit

Click the Override upload limit button. You can now set your own limit on the upload size of images. For each user type, edit the numeric value field on the left, and choose a unit of measurement (b, Kb, Mb) from the menu on the right.

Branda-images-limits-override

7.5.3 Site Generator

Link to chapter 5

The Site Generator module allows you to change the generator information and link from WordPress that appears in your site’s source code to your own brand or whatever you prefer. Click Activate to proceed.

Activate-Branda-site-generator

In the fields provided, enter the text, link, and version information you want to display instead of the default WordPress text.

Edit-Branda-site-generator-info

7.5.4 Text Replacement

Link to chapter 5

Replace any text from your admin pages and/or front-end pages with this easy to use, find and replace-like interface. For example, you can use this tool to replace the word “WordPress” with your own website name throughout your website, even when it appears in links. You can also hide text that you would like to remove but not replace, by leaving the Replace with field blank. For instance, this feature could be used to hide the “Proudly powered by WordPress” footer on your website. Click Activate to proceed.

Activate-Branda-text-replacement

Each piece of text you wish to replace requires a rule, and you can create as many rules as you need. The first time you access the Utilities module, you will be prompted to add a rule. Create a rule by clicking the Add Rule button.

  • Find Text – Enter the text you wish to be replaced.
  • Replace with – Enter the text you wish to appear in place of the the text entered in the Find Text field. Alternatively, you can leave this blank to simply hide the text specified in the Find Text field.
  • Text domain – If you want to target text from only a specific plugin or theme, enter the text domain identifier in the “Text domain” field. Below the text domain field is a link to the WordPress codex file on that subject.
  • Scope – Determines what pages will be affected by the rule. Apply the rule to All Pages, Admin Pages or Front-end Pages, by clicking the corresponding button.
  • Case matching – Apply case sensitivity to your rule by clicking the Case Insensitive and Case Sensitive button as needed.
  • Link Text – If the rule you are creating is intended to change link text, click the Include button. Replacing link text with this Text Replacement tool will not interfere with the link’s functionality.

text replacement settings

To edit any existing rule you have added, click the pencil icon in that rule’s row. Click the trash icon to delete a rule. You can also bulk delete rules using the Bulk Actions option at top-left.

Branda-text-replacement-rules-list

7.5.5 Tracking Codes

Link to chapter 5

The Tracking Codes module allows you to insert tracking code into your website at different locations, such as within the head tag, or after/before the body tag. There is also an option to insert code on the whole website or insert it conditionally. Click Activate to proceed.

Activate-Branda-tracking-codes

The first time you access the Tracking Codes module, you will be prompted to add your first tracking code. Click the Add Tracking Code button to proceed.

General Tab

  • Status – Click the Inactive/Active button to enable or disable a tracking code as needed.
  • Name – Enter a title for this tracking code so you can easily identify it from the list.
  • Tracking Code – Paste your tracking code into the HTML editor, and click the Insert button.

Branda-tracking-codes-general-tab

Location Tab

  • Insert Position – Click the appropriate button to indicate where your code should be inserted.
  • Location Filters – click the Enable/Disable button to indicate whether you want location filters enabled.

Branda-tracking-codes-location

With Location filters enabled

  • Users – Click the User field, and select the user roles and/or user status for which this code will apply. You can apply multiple filters for each code insertion.
  • Authors – Click the Authors field to choose a specific user/author for which this code will apply. This filter will apply only on single entry post types from that user/author.
  • Content Type – Click the Content field to choose the content types for which this code will apply. You can apply multiple content types for each code insertion.

Branda-tracking-codes-filters

7.5.6 Website Mode

Link to chapter 5

The Website Mode module creates quick and easy Coming Soon and Maintenance Mode pages.The tool is designed to create a Coming Soon page for sites that are under construction, after which the Maintenance page exists to be activated during periods when a site is offline for any reason. The pages do not exist simultaneously. Click Activate to proceed.

Activate-Branda-website-mode

Configuration

Click the Coming Soon or Maintenance button, depending on the type of page you wish to create.

If you’re working within a multisite network, you’ll have additional options to select where to display your page. Click the All Sites button to display the page for every site in the network. Click the Selected Sites button to apply the page to only specific sites. Enter the name of a subsite you wish to add to the list, and click Add. Repeat the process for every subsite you wish to add to the list.

Branda-website-mode-configuration

Content

Logo & Background
If you wish to add a logo or background image to the page, click the arrow to the right of “Logo and Background” to reveal a configuration panel. The configuration here is identical to that in the DB Error Page module.

Branda-website-mode-logo

Display Message
Click the arrow next to “Display Message”, and use the post-type editor to create the custom message you wish to display on your coming soon or maintenance mode screen.

Branda-website-mode-message

Countdown Timer
If you wish to display a countdown timer on the page, click the arrow next to “Countdown Timer”, then click the Show button. Enter a “Till Date” and “Till Time”, and the page will be disabled at that time, displaying your intended landing pages instead.

Branda-website-mode-timer

Social Accounts
To add social network sites to your Coming Soon or Maintenance page, click the arrow next to “Social Accounts”, and then click the Add Accounts button. The configuration here is identical to that in the DB Error Page module.

Branda-website-mode-social-options

Design

Logo
Click the dropdown arrow to the right of Logo to customize that element’s display properties. Use the fields provided to set the width, opacity, position on the screen, margins and corner radius. The configuration here is identical to that in the DB Error Page module.

Branda-website-mode-logo-design

Background
Click the dropdown arrow to the right of Background to customize how background images are displayed. The configuration here is identical to that in the DB Error Page module.

Branda-website-mode-background-design

Countdown Timer
Click the arrow next to “Countdown Timer” to choose the style of the countdown timer displayed on your page.

Branda-website-mode-timer-design

Social Accounts
Click the arrow next to “Social Accounts” to reveal the configuration panel. The configuration here is identical to that in the DB Error Page module.

Branda-website-mode-social-design

Content Wrapper
Click the arrow next to “Content Wrapper” to modify the width and corner radius of the content wrapper displayed on your Coming Soon or Maintenance page.

Branda-website-mode-content-wrapper-design

Colors

Logo & Background
Click the color swatches to open the color pickers, and choose the colors you want applied to the logo and background. You can also enter the Hex Color Code in the field provided. Click Select to confirm your choice.

Branda-website-mode-logo-colors

Display Message
Click the color swatches to open the color pickers, and choose the colors you want applied to the title and error message text. You can also enter the Hex Color Code in the field provided.

Content Wrapper
Click the color swatch to open the color picker, and choose the color want applied to the background of your website mode page. You can also enter the Hex Color Code in the field provided.

Custom CSS

Use the CSS editor to apply advanced customization to your Coming Soon or Maintenance page. CSS applied here will only affect these two pages. Preset selector buttons are provided for each customizable area.

  • Overall – Apply CSS to both the Coming Soon and Maintenance pages.
  • Page – Apply CSS to a specific page,
  • Clock – Apply CSS to the Countdown Timer.
  • Content – Apply CSS to the Error Message displayed on the page.
  • Social Media – Apply CSS to the displayed social account icons.
  • Logo – Apply CSS to the uploaded custom logo.

Branda-website-mode-css

7.6 Widgets

Link to chapter 6

Branda Widget modules allow you to customize the default WordPress dashboard widgets or add custom feeds to the WordPress dashboard, and to customize the front end Meta widget to match your branding. Click Activate to proceed.

7.6.1 Dashboard Feeds

Link to chapter 6

The Dashboard Feeds module enables you to create your own feed widgets for your WordPress dashboard. Click Activate to proceed.

Activate-Branda-dashboard-feeds

When entering the Dashboard Feed module for the first time you will be prompted to create your first feed. Click the Add Feed button to proceed.

Add Dashboard Feed

The Add Dashboard Feed panel contains three tabs, General, Display, and Visibility. Adjust the options under each tab as needed, then click the Add button to add the feed to your dashboard.

General

  • Site URL – Enter the main URL of the site whose feed you want to use.
  • Feed title (optional) – Enter the feed title that will appear at the top of your feed widget.
  • Feed URL – Enter the URL of the feed itself here.

Branda-dashboard-feeds-add-new

Display

  • Count – Enter the number of items you want to display from the feed.
  • Content – Select Excerpt or Full Content to determine how much of any feed item to display.
  • Author – Select to Hide or Show the display of author names.
  • Date – Select to Hide or Show the creation date of feed items.

Branda-dashboard-feeds-display-options

Visibility

  • Dashboard – Click the Hide/Show buttons to control whether a feed is displayed on the dashboard of a single site or on the dashboards of every site in a network.

Branda-dashboard-feeds-visibility-options

Here’s an example of a Custom Feed as it appears on the dashboard.

Branda-dashboard-feeds-example

7.6.2 Dashboard Widgets

Link to chapter 6

The Dashboard Widgets module allows you to replace the default WordPress dashboard widgets with your own custom content and to create a custom dashboard welcome message,  Click Activate to proceed.

Activate-Branda-dashboard-widgets

Widget Visibility

Choose the widgets which you want to remove from all the dashboards on your site or network by clicking the corresponding checkboxes. Note that any feeds you added in the Dashboard Feeds module will appear here, along with any custom Text widgets you create below, as well as the default WordPress widgets.

Branda-dashboard-widgets-visibility

Dashboard Welcome

You can customize the default WordPress welcome message that appears to new users by adding your own message, images, and links.

Use the post-type editor to customize the welcome message. First, choose whether you want to allow shortcode parsing within the welcome message or not; but be careful, as it can break compatibility with themes with UI builders.

Branda-dashboard-widgets-welcome

Text Widgets

Add text widgets with your custom content to the WordPress dashboard by clicking the Add Text Widget button.

Branda-dashboard-widgets-custom-text

Craft your message using the post-type editor.

Branda-dashboard-widgets-edit-custom-text-widget

7.6.3 Meta Widget

Link to chapter 6

Use the custom meta widget module to rebrand the default meta widget on your site or all multisite blogs with one that has the “Powered By” link branded for your site. Click Activate to proceed.

Activate-Branda-meta-widget

Once activated, the Meta Widget module will automatically replace the “WordPress.org” link in the meta widget with your website’s title that links back to your site. Deactivate the module to return the Meta Widget to its default state.

Branda-meta-widget-activated

7.7 Settings

Link to chapter 7

Branda Settings include accessibility, data preservation, and import/export functions.

7.7.1 Data

Link to chapter 7

The Data tools control how your Branda settings and other data are handled when you export or uninstall the plugin. Settings refer to the module configurations, while Data includes transient bits created over time, such as logs, frequently used modules, last import/export time, and other pieces of information.

Uninstallation

In the event you want to uninstall Branda, but may want to reinstall it at a later time, click the Preserve button to save your configurations, so they may be quickly reapplied when you reinstall the plugin. If you wish to reset all configurations to their default state, click the Reset button.

Branda creates logs, frequently used modules data, last import/export time, and other pieces of information that you may find useful. Click the Keep button if you wish to preserve this data when you uninstall the plugin, or click the Remove button if you don’t want the data preserved.

Branda-settings-uninstall-options

Multisite admins should note that the above options only affect the main site’s data. Click the Delete Subsites Data button to delete network subsite data before uninstalling the plugin.

Branda-settings-uninstall-subsite-options

Reset
Click the Reset button to return all modules to their default state, without eliminating any data generated since the original installation or last reset.

Branda-settings-reset

7.7.2 Permissions

Link to chapter 7

User Permissions

  • User Roles – Select the user roles who can access and configure Branda options and settings.
  • Custom Users – Add any specific users who can access and configure Branda options. Note this overrides the above user role settings.

Branda-permissions-settings

Subsite Controls (Multisite Only)

In multisite installs, you can select whether subsite admins can override Branda settings or not.

  • None – Subsite admins can’t override any module settings and will always inherit your network settings.
  • All – Subsite admins can override any default module settings set in your network settings.
  • Custom – Select the modules that subsite admins can override on their subsites.

Branda-settings-subsites-permissions

7.7.3 Accessibility

Link to chapter 7

Click Enable High Contrast Mode to increase the visibility and accessibility of Branda elements and components to meet WCAG AAA requirements. When enabled, High Contrast Mode only effects elements within the Branda UI.

Branda-accessibility

High Contrast Mode adds a black fill to some elements to improve their visibility.

Branda-accessibility-enabled

7.7.4 Export

Link to chapter 7

The Export tool allows you to export your Branda configurations into a JSON file to apply to another website. Click the Include debug info if you want to include debug information in the export file. Click the Export button to create the JSON file.

Branda-export-option

7.7.5 Import

Link to chapter 7

The import tool allows you to upload a JSON file and import Branda settings from another website. Use the file uploader to load the JSON file, and click the Import button to apply the setting to the Branda plugin installed elsewhere.

Branda-import-option

7.8 White Label WPMU DEV Plugins

Link to chapter 8

WPMU DEV gives you the option to white label (remove/replace branding in WPMU DEV plugins). Add a custom logo, remove the WPMU DEV documentation button and the default WPMU DEV footer text, where you can replace our text with yours.

This is all managed from the Tools section of the WPMU DEV Dashboard plugin.

For more information and a look at configuration options for white labeling your plugins, visit the WPMU DEV Dashboard plugin documentation.

NOTE

Check out our complete suite of white label features including white label analytics in the WPMU DEV Dashboard plugin and custom client and developer reports in the Hub.

7.9 Get Support

Link to chapter 9

After reading this guide, if you still have questions regarding Branda, don’t hesitate to start a live chat with our support Superheroes or submit a support ticket using the Support tab of your WPMU Dev Dashboard.

Navigate to WPMU DEV DASHBOARD > SUPPORT > NEW TICKET to submit a support ticket.