Table of Contents
Installing the plugin
After you buy the plugin, you should receive an email receipt from Nose Graze. This email will contain a link to download a .zip file containing the plugin. Once you have the zubb-review-request.zip file downloaded, login to your WordPress site.
Navigate to Plugins » Add New and click on Upload. Select the .zip file from the upload link and press "Install Now". Once it installs, click "Activate" and then you're done.
Activating your license key
If you wish to enable automatic updates, you need to enter your license key. To do this, navigate to Ultimate BB » License. You'll see a new box there specifically for the Review Request License. Enter your key there and press "Save Changes". When the page reloads, you will need to click the Activate button below your license key. The key will not be activated until you click that button!
The settings panel
The settings for the Review Request add-on are located in Ultimate BB » Review Requests. This is where you can configure the form fields and other settings.
Setting up form fields
The first thing you should do is decide which fields you want to appear on your submission form. You can do this by configuring the settings in Ultimate BB » Review Requests. There's a drag and drop interface for enabling and disabling form fields.
Four fields are required in order for the form to work:
- Your Name
- Contact Email
- Book Title
- Book Author
You must have these fields in the "enabled" column.
Some of the form fields are headings. For example: "Heading #1" and "Heading #1". These headings are configurable HTML fields. You can add text or HTML to break up the sections. You enter the HTML for these boxes by hovering over one and clicking the blue "Edit Text" button. This will bring up a box like so:
The default text for "Heading #2" is:
But you could edit that or add additional instructions. For example:
<h2>Book Information</h2> <p>Please enter information about your book in the fields below.</p>
Adding the request form to a page
To add the review requests form to a page, simply create a new page and add the following shortcode in the post box:
This will insert the form.
New Admin Tab
The plugin adds a new tab to your admin panel called Review Requests. All entries through the form get sent to this page. You can edit the requests like you would a post.
Review Request Information
There is a new box for all the request information. You'll see the requester's name, contact email, and other details.
There's a section for "your tools" where you can assign a reviewer to this book (great for blogs with multiple reviewers), you can copy the book to a new post draft, or you can email the requester.
UBB Book Information
The UBB book information is also present on this page. This includes all the book information that the submitter provided.
Copy to new post draft
In the "Your Tools" section you have the option of copying the book to a new post draft. This will create a new post draft for you and will insert all the book information from the request into the Ultimate Book Blogger fields.
Version 2.1.6 and higher has added extra tools and features to help with GDPR compliance. Review requests store names and email addresses in your database, which falls under storing personal information under GDPR.
Under GDPR you are also obligated to provide users with an export of their personal data if they submit a request. The Review Requests add-on will add a user's submitted requests to the WordPress export tool (Tools > Export Personal Data). Any review requests submitted by that email address will be included in the exporter. Each request entry will include:
- The requester's name
- The requester's email
- Giveaway options
- Giveaway prize
- Promotions agreed to
- Review request etxt
If you process an erasure request for a user then requests are not deleted, but they are anonymized. This means the user's name, email address, and review request text will be removed, but the actual request entry will remain available. The request will no longer contain personal information, making it compliant with GDPR.