Notices Setup

Overview

This document provides instructions on how to set up the Notices extension and add notices to your site using this extension. These conditional notices may be used to alert users to important information or let them know about promotions or new features.

Contents

• Installing an Extension
• Settings
• Creating a notice
  
  • Options
  • Footer rules
  • Styling
  • Call to action
• Shortcode
• Cookies & Flush

Installing an Extension #

You can download the extension via your account on our website. If you have made an individual extension purchase you can download the extension via the download tab on your account page or if you have purchased the pass you can download the extensions via the downloads page. Once the extension is downloaded you should install and activate it using the WordPress plugin installer on wp-admin > Plugins. Read the article Installing an Extension for details.

Settings #

Once you activate the extension, you will see the Notices tab in wp-admin > Ultimate Member > Settings > Extensions.

On this page, you'll find the "Notice Position in Footer" option that sets the position of footer notices. You can select to show footer notices on the left or right. This is a global option and applies to all notices.

Creating a notice #

Navigate to wp-admin > Ultimate Member > Notices to see existing notices. 

Click the "Add New Notice" button to create a new notice. Give the notice a title and enter the text you want to show in the notice.

 Image - The new notice title and text on  wp-admin > Ultimate Member > Notices > Add New Notice

Note: Make sure to fill the content field. Empty notice content is not valid, the post will not be published but saved as a draft.

Once the title and text are entered, you can customize the conditions to display and view a notice using the settings below:

Options #

• Allow this notice to appear in footer – All notices have to appear in the footer by default. If you turn this option off, the notice will not appear in the footer, and you will need to use the shortcode to add it to your site.
• Display this notice to logged out users – This option allows you to decide whether or not logged-out users can see the notice.
• Display this notice to logged in users – This option allows you to decide whether or not logged-in users can see the notice.
  • Show only to certain user(s) – Optional. This option allows you to choose specific user/s from a multi select drop-down list of user IDs or usernames to display the notice to. 
  • Which user roles can see this notice – Optional.This option allows you to decide which user roles can see the notice. This option becomes hidden if you choose a specific user from the "Show only to certain user(s)" selection.
  • Show If the user did not – Optional.This option allows you to show the notice to logged-in users whose profiles don't contain required information. Choices: "Uploaded a profile photo," "Uploaded a cover photo", "Other" (you must paste the meta_key for the field you need into the option below). Select "--" (default) to disable this condition.
    • Show If the user did not fill that metakey –This option becomes accessible when you choose "Other" from the "Show If the user did not" option. It enables you to display the notice to users who have not completed a specific field. You are required to fill this option with the corresponding metakey.

Note: The option "Show If the user did not fill that meta key" is required if the option "Show If the user did not" is set to "Other."

Footer rules #

• Show everywhere on website – This option allows you to display the footer notice across your entire website. If enabled, other footer rules options are hidden.
• Show on specific URLs only – This option allows you to only show the footer notice on specific URLs. If enabled, it hides the other footer rules options below; however, the "Extra allowed URLs (one per line)" field remains visible, allowing you to paste URLs into its text area (1 URL per line).
• Show on Homepage – This option allows you to decide whether or not the notice is shown on your site's homepage.
• Show on Posts – This option allows you to decide whether or not to show the notice on posts.
• Show on Pages –This option allows you to decide whether or not to show the notice on pages. If you want to show the notice to only a specific page, disable this option and add the page URL in the Extra allowed URLs option.
• Show on Custom Post Types – This option allows you to decide whether or not to show the notice on custom post types. This option becomes accessible or appears only when a plugin with a custom post type is activated.
  • Choose Post Types* – This option appears only if Show on Custom Post Types is enabled. You're required to select from this option; it displays the selection list of the custom post types available.
• Extra allowed URLs one per line – This options allow you add URLs of the other specific pages you want to show the notice. (1 URL per line)

Note: If "Show on Homepage" is disabled, but you've entered your homepage URL in the text area field of the "Extra allowed URLs (one per line)" option, the notice should be visible.

Styling #

The styling section allows you to customize the appearance of the notice, including colors, size, and adding an icon to the notice.

CTA (Call to action) #

• Enable Call to Action button – If you want to show a button in the notice, you can turn it on with this option. If turned on, you'll see additional options to customize a button:
  • Button Text
  • Button URL
  • Button Background Color
  • Button Text Color

Shortcode #

Every notice comes with its shortcode, which you can use to show the notice anywhere on your site. Notices can appear as both a footer notice and a shortcode notice, or you can turn on the footer notice so that the notice is only used as a shortcode. If you have a notice as both a shortcode and a footer notice, the footer notice will not appear on the same page where the shortcode is added (this is to stop the same notice from appearing twice on the same page).

Example:

[ultimatemember_notice id="123"]

Cookies & Flush #

To stop the notices appearing to users after they have closed the notice, the extension will remember using cookies for logged-out users and the user id for logged-in users. Each notice can be flushed, which means that the notice will appear again for logged-in users who closed the notice. However, the flush function only works for logged-in users. For logged-out users to see the notice again, they must delete their cookies.