Read and Understood

About this plugin

   1) The WP username of the logged in reader who made one or more acknowledgments
   2) If so configured, the username entered by a person who is NOT logged in
   3) If "all Users" is checked to export, the WP username with no acknowledgments

   1) The user_id of the logged-in user who acknowledged the posting(s).
   2) A zero "0", signifying that no person was logged in when the post was acknowledged
   3) The user_id of person who acknowledged NO postings (and t.he ALL USERS option was selected)

Questions

Installation Instructions

1. Install Plugin by one of three methods:
   a. If using a multisite, install plugin from dashboard using MySites=>NetworkAdmin=>Plugins
   and select ADDNEW. Otherwise, from dashboard select Plugins=>AddNew.
   b. In the SEARCH PLUGIN box in the upper right, enter READ AND UNDERSTOOD and press enter.
   c. Select the READ AND UNDERSTOOD plugin by Mantos I.T. Consulting, Inc, press INSTALL NOW.
   d. Alternative to above steps: Download the plugin from any trusted site, extract if in ZIP format,
   and upload the plugin read-and-understood files to the /wp-content/plugins/ directory
2. Activate the read-and-understood plugin through the ‘Plugins’ menu in WordPress.
3. Configure: Use the Settings link on the WP Admin page and look for the Read and Understood menu
   a. Optionally choose categories. Posts in any of the selected categories may be acknowledged
   and the READ AND UNDERSTOOD button will appear at the end of the post. Use the CTRL-click
   to select and deselect categories.
   b. Optionally add the [rnu_ack] shortcode into any posts that are to be acknowledged that or not
   in any categories selected above. The READ AND UNDERSTOOD button will appear wherever the
   shortcode was placed. NOTE: If a shortcode is placed in a post which is also of a selected
   category, more than one READ AND UNDERSTOOD button will appear in that post.
   c. Optionally allow users to acknowledged postings in that category without having a login
   If you chose that option, you may also restrict the format of the usernames
   If you know what a regular expression is, you may configure your own format for usernames
   The default allows for a 1 to 10 character username using capital letters only.

Does RnU work with custom post types?

No, it does not.

At the heart of RNU, there is a function called append_post_notification
and there is a line in there that says “if($post->post_type == ‘post’) {“

The intent is so that the Read-and-understood button doesn’t show up on “regular” pages of the web site.
Otherwise, visitors to the website might see the Read-and-Understood acknowledgment button on every page.

The post types are:
Post (Post Type: ‘post’)
Page (Post Type: ‘page’)
Attachment (Post Type: ‘attachment’)
Revision (Post Type: ‘revision’)
Navigation menu (Post Type: ‘nav_menu_item’)

The program logic could be changed to be something of the nature of “is anything but (the 4 other types)”,
in which case, the RnU acknowledgment button would appear on pages of custom post types.

However, there may be people who are using the plugin who take advantage of the fact that the RnU button shows
up only on posts of type ‘post’ and that it does NOT show up on custom post types.

Any enhancement along these lines would want to make the post-types user-selectable.

Are there any known issues?

Sometimes, using Chrome and perhaps in other browsers, the header row of the CSV file appears blank when automatically
opened using Microsoft eXcel 2010. Hitting export again shows the download with the headers.