=== Read and Understood === Contributors: petermantos Requires at least: 3.0 Stable tag: 1.2 Tested up to: 3.8 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Tags: Acknowledgement, Accountability, Mantos, Acknowledge, Read, Understood, Understand == Screenshots == 1. The Read and Understood administration screen. 2. The Read and Understood button at the end of a posting == Description == Read-and-Understood is a solution to the "I didn't get the memo" problem. The Read and Understood (RnU) WordPress plugin offers readers the opportunity to record an acknowledgement that they have read a specific posting. You can visit us at: One common use of RnU is by employers to record that employees have read postings in a specific, private category such as 'internal' which may only be seen by authorized, logged-in users. By doing so, the employee may assume responsibility for understanding the content and following any instructions, procedures, or policies contained in it. These acknowledgements may then be accessed by administrators via a CSV file containing records created in a given date range. The records are exported using an Export button on the plugin's setting page. In addition to exportation, the records are accessible through any technique used to access a typical MySql database such as PHPadmin, linked tables, or custom programming. The acknowledgements may also be purged (deleted) using the PURGE button also found on the plugin's setting page. Optionally, the plugin may be configured to accept acknowledgements from users who are not logged-in. In that case, the user may enter any username desired provided that it meets an administrator specified format as defined by a regular expression. The default format for such usernames, if allowed, is 1-10 capital letters. An Export file contains the following headers: RNU_USERNAME .............. The WP username of the logged in reader, or the one entered if allowed post_title ................ The WP title of the posting acknowledged id_RNU_ACKNOWLEDGMENT ..... A unique number identifying the acknowledgement record RNU_USER_ID ............... The userid of the logged-in WP user (or 0 if not logged-in) RNU_POST_ID ............... The post id of the posting acknowledged RNU_ACK_DATETIME .......... The date and time the posting was acknowledged by the user == Installation == 1. 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. Choose a category. Only posts with this category may be acknowledged. b. 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. == Frequently Asked Questions == = Has anyone Asked any questions yet ? = No. = 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. == Changelog == = 1.2 = * Corrected instance of _( with __( as reported in Support forum = 1.1 = * Corrected display of number of record to be purged on confirmation button * Corrected number of records purged message * Replaced incomplete copy of jquery.js with 1.7.2 * Turned off WP_DEBUG for production. * Created css/images to house jquery-ui images * Moved rnu_uninstall outside of class * Exploits, but does not require JavaScript. * Moved JavaScript to external file in /js folder * First draft of test plan included in /test folder * Ready for Translation, including JavaScript files = 1.0 = * Corrected the description of the login required checkbox by removing "not" * Placed many more string literals in __(...) for future translation = 0.2 = * Removed remote reference to jquery-ui.css and included local copy