11.7 Settings
The Settings section is where you’ll find all the options that apply to the plugin interface itself, as well as some options that apply to all modules.
11.7.1 General
Dashboard
Modules Listing
These options enable you to choose what info to display on the Hustle > Dashboard screen for each module type.
- Number of (Modules) – Select how many of each module type you want to show on the Dashboard screen.
- Status – Select to show only Published, only Drafts, or both for each module type.
Global Tracking
Views and conversions of all your modules are tracked by default. If you do not need or want tracking at all, you can disable it for all modules with this option.
Simply click the toggle to disable views & conversions tracking for all your modules.
Enabling this feature will also remove all tracking-related options from the following locations:
- The options menus in the module dashboards
- The options menus in individual modules
- The Top Metrics that can be displayed in the plugin Dashboard
- The Dashboard Analytics widget that displays in your WordPress dashboard
If you already had tracking enabled on some modules, and wish to reset tracking data to zero before enabling this feature, you can use the Reset Tracking Data option in individual modules, or select them on the module dashboard and use the same option in the Bulk Actions menu.
Multisite Global Tracking
If Hustle is network-active in a multisite installation, this option will only affect the site where it is enabled. If you want to disable global tracking on all subsites, you can either do that on each subsite individually, or use the following filter in a mu-plugin:
add_filter( ‘hustle_global_tracking’, ‘__return_false’ );
From Headers
Here, you can customize the email address & name that will appear in the header of any email notification sent from Hustle. Note that if you have either the From Headers or SMTP modules configured in our Branda plugin on your site, that will override these settings in Hustle.
- Sender email address – All Hustle emails would be sent from this email address.
- Sender name – Hustle emails would be sent from this name.
Responsive Options
The responsive settings you may have configured in any module kick in when the viewer’s detected device width is 782px or less. You can adjust this default breakpoint value here if needed.
Pagination
By default, Hustle will display up to 10 of each type of module and submission per page on the main screen of each module or submission type. You can adjust that number here if needed.
Debug Mode
If you are experiencing unexpected issues with Hustle, you can enable Debug Mode so any errors or warnings generated by the plugin can be logged in the debug.log file located in the wp-content directory.
Note that both WP_DEBUG, and WP_DEBUG_LOG defines must be set to true in your wp-config file. If they are not, Hustle will alert you so you can get that done first.
11.7.2 Color Palettes
Here is where you can create your own custom color palettes that better fit your brand and site design, and use them in any module instead of the default palettes. Click the Create Custom Palette button to get started.
In the options modal that pops open, start by giving your custom color palette a name so you can easily spot it in the Color Palette lists in your modules. Note that you can’t change the color palette after creating it.
Next, select to use either a default color palette as your base, or import the current color configuration from one of your existing modules instead. Click the Next button to continue.
- Default Palettes – If you choose this option, simply select the default palette you want to start with.
- Import from a Module – If you choose this option, you’ll be prompted to select the module type and name to use as your custom base, as well as select a default color palette used to import any color options that have not been customized in your selected module. This is the option you’d want if you’ve already set up a color scheme in a module that fits your brand perfectly, and want to replicate that in all other modules.
You’ll then see the color options available for every element that applies to every module type. Use the color pickers to customize the color scheme exactly how you want it, in the same way you may have already customized things in one of your existing modules. For more on the specifics of this, see the Colors section in the Creating Modules > Appearance chapter above.
You’ll find all the elements common to both Opt-in and Informational module types under the General tab, and options specific to opt-in form elements under the Opt-In tab.
Click the Expand All link to pop open all the options if needed.
Remember to click the Save button at the bottom of the color options.
You’ll then see your custom color palette appear in the list on the Color Palettes screen where you can pop open the options to edit it if needed by clicking the pencil icon in its row.
You’ll now be able to select your custom color palette when creating or editing any module.
11.7.3 Dashboard Analytics
This option adds analytics tracking for your Hustle modules that doesn’t require any 3rd-party integration, and displays the data in a widget on your wp-admin Dashboard screen.
Once enabled, you can customize the following options:
- Widget Title – Enter the title you wish to appear in the Dashboard screen widget.
- User Role – Select the user roles who can view the widget and its data.
- Modules – Select which modules to show data for in the widget.
One you’ve saved your configuration, the widget would look like this in your wp-admin Dashboard screen. You can filter the data in the widget as follows:
- Show – Select to view All Conversions, only CTA Conversions, only Opt-in Conversions or Conversion Rate.
- from – Select to view data from last 7, 30 or 90 days.
11.7.4 Data
Uninstallation
Here you can choose what should happen with Hustle’s plugin data upon uninstallation. Click Preserve to keep your data intact, or click Reset to delete all plugin data upon uninstallation.
For multisite installations, you can additionally choose what happens to subsite data upon uninstallation.
Reset Plugin
Click Reset to immediately delete all plugin data, for instance if you want to start over with a fresh install.
11.7.5 Viewer’s Privacy
The privacy options in Hustle enable you to comply with GDPR, HIPAA and other similar data privacy laws that may be in effect in your country of operation.
IP Address
- IP Tracking – Choose to enable or disable the collection of users’ IP data when they submit your Opt-Ins and when tracking conversions.
- IP Retention – Choose for how long IP data should be preserved in the database.
- Delete IP Addresses – If you need to Delete IP Addresses, click the button to pop open a modal window.
In the modal that pops open, select to delete all IP address data, or only specific IP addresses.
Submissions Privacy
- Submissions Retention – Choose for how long module submissions should be preserved in the database.
- Account Erasure Requests – Choose whether to retain or remove submission data when you receive a WordPress account erasure request from a user. If you choose “Remove Submission”, the data will be deleted when the user confirms the erasure request you create under Tools > Erase Personal Data in your site admin.
Tracking Data Privacy
Tracking Data Retention – Choose for how long conversion tracking data should be preserved in the database.
PRIVACY POLICY
Hustle includes suggested text to use in your site’s Privacy Policy page for each active feature that may require it. To view this text, go to Settings > Privacy in your wp-admin, and click the “Check out our guide” link.
11.7.6 Permissions
By default, only users with the administrator role can access and edit things in Hustle. The Permissions settings enable you to set which additional user roles can perform the following tasks in Hustle.
- Create and Update Modules – Select which user roles can create new modules and update existing ones.
- Edit Existing Modules – Select the roles who can edit existing modules.
- Access Email List – Select the roles who can access the Opt-In email lists.
- Edit Integrations – Select the roles who can edit the 3rd-party app integrations.
- Edit Settings – Select the roles who can edit the Hustle plugin settings.,
For each option, click in the textarea and select the user roles you wish to have access.
11.7.7 reCAPTCHA
Every Opt-In module includes an optional Google reCaptcha field that you can include in the form. But you need to configure reCaptcha here first.
API Keys
Each reCaptcha type (v2 Checkbox, v2 Invisible, v3) requires its own set of API keys, so you want to ensure you create the correct type in your reCaptcha account at https://www.google.com/recaptcha/admin#list
We recommend setting up each type in the settings here so you can simply select the type you want to use in each Opt-In module you create with no worries about it breaking in the form.
Language
If you have opted to show the reCaptcha badge in any Opt-In, it will display in your site language by default. But you can change that language here if needed.
Now when you add a reCaptcha field to your Opt-In, it would look something like this assuming you have chosen to show the badge:
11.7.8 Accessibility
Enable High Contrast Mode to increase the visibility of plugin settings by providing a stark back on white contrast.
With this option enabled, plugin settings would like this example from the Data settings screen above.
11.7.9 Top Metrics
By default, the Hustle > Dashboard screen’s overview section displays the following metrics:
- Average Conversion Rate – The total number of conversions divided by the total number of views on all the modules.
- Total Conversions – The sum of all the conversions up to today from all modules.
- Most Conversions – The module with the highest number of conversions.
The options here enable you to select which metrics you want to be shown in that overview instead of the above defaults. Following are the additional optional metrics you can choose to display instead. Note that you can only have 3 top metrics showing in that section, so you’ll want to first de-select any one of the defaults before you can select the replacement.
- Today’s Conversion – The total number of conversions today from all modules.
- Last 7 Day’s Conversion – The total number of conversions from all modules for the last week.
- Last 1 Month’s conversion – The total number of conversions from all modules for the last month.
- Inactive Modules – The total number of inactive modules including all drafts and unpublished modules.
- Total Modules – The total number of modules regardless of their status.
11.7.10 Unsubscribe
The Unsubscribe options enable you to add a simple form anywhere on the frontend of your site where your Opt-In subscribers can unsubscribe if they wish.
Note that if your optin module is sending data to any connected apps, a user who chooses to unsubscribe will be unsubscribed from your local list as well as from the lists in those connected apps.
Shortcode
You can use the auto-generated shortcode anywhere you want the unsubscribe form to appear. By default, it will allow users to unsubscribe from all lists, but you can specify for which modules you want to enable the unsubscribe option by including the module IDs in the shortcode.
When adding multiple module IDs in the shortcode, be sure to add them as a comma-separated list like the example below:
[wd_hustle_unsubscribe id=”5,10,11,15″]
You can find a module’s ID in the URL of the module’s wizard page, for example: /wp-admin/admin.php?page=hustle_popup&id=58
You can add the skip_confirmation attribute inside the unsubscribe shortcode and set its value to true to allow users to unsubscribe from all modules that you specify in the shortcode with one click. Here is an example of how your shortcode will look like:
[wd_hustle_unsubscribe id=”5″ skip_confirmation=”true”]
Gutenberg Block
In addition to the shortcode that you can use anywhere, you can also embed the unsubscribe form in any page or post using Hustle’s Gutenberg block.
In the Block settings, you can optionally select specific modules that you want users to be able to unsubscribe from using that form. If none are selected, the unsubscribe form will default to all modules.
If you want users to be unsubscribed automatically from all modules you select here, without having to select them themselves, check the Skip confirmation step box.
Customize Unsubscribe Form
Enable this option to customize any of the messages that appear on-screen when users interact with the unsubscribe form.
Unsubscribe Email Copy
When users unsubscribe from any of your opt-in lists, they must click a link in an email sent to their email address to confirm their action.
Enable this option to customize the subject and body of that confirmation email. Note that the {hustle_unsubscribe_link} placeholder must be somewhere in the email body for the confirmation link to be included.
Unsubscribe Email URL Filter
There may come a time when you may wish to direct users to a specific page where they can unsubscribe from specific email lists.
For example, you have the unsubscribe shortcode added to two or more pages where users can unsubscribe from one or a few specific lists, but want to have a different unsubscribe page for users who click on the link in an email.
In such a case where there is more than one instance of the unsubscribe shortcode on your site, the email link will default to the most recently added instance of that shortcode.
This filter comes in handy to change that default behavior: hustle_unsubscribe_email_url
As an example of how you can use this filter, let’s say you have several active opt-in modules, but want your users to be able to unsubscribe only from selected lists. You also have the unsubscribe shortcode in several places on your site. You could use the filter to specify which modules they can unsubscribe from, and on which specific page, like so:
<?php | |
add_filter( ‘hustle_unsubscribe_email_url’, function( $unsubscribe_url, $email, $modules_id, $referer ) { | |
$special_module_ids = array( 109, 110, 111 ); | |
if ( array_intersect( $special_module_ids, $modules_id ) ) { | |
$special_unsubscribe_url = ‘https://dev.wpmu/f/’; | |
$get_params = preg_replace( ‘/^.*token=/’, ‘token=’, $unsubscribe_url ); | |
$unsubscribe_url = $special_unsubscribe_url . ‘?’ . $get_params; | |
} | |
return $unsubscribe_url; | |
}, 10, 4 ); |
- Add the module IDs in the $special_module_ids array.
- Add the full URL to your desired unsubscribe page as the $special_unsubscribe_url