=== Dashboard Site Notes === Contributors: BenIrvin Donate link: http://innerdvations.com/ Tags: dashboard, notes, messages, admin, instruction, manual Requires at least: 3.0 Tested up to: 3.3.1 Stable tag: 1.3.2 Add notes as admin notices in contextual help tabs, as well as compile them into an instruction manual. == Description == Add notes as admin notices in contextual help tabs, as well as compile them into an instruction manual or placed in a dashboard widget. This is intended to build instructions into a site for clients, so it is focused on providing abilities only to the highest role of user available on a site, although it can be configured as a general purpose tool to leave temporary notes to any group on your site that has admin access. == Installation == 1. Upload the plugin folder to the `/wp-content/plugins/` directory 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Go to Settings->Site Notes and configure the plugin as needed 1. Start adding site notes. Choose at least one role and location, or your note won't appear. == Frequently Asked Questions == = Any known issues? = * Very little testing has been done in the last few versions with multisite or child/parent notes, so if you're using those, it's possible you could see some strangeness. * translations are very out of date * if you had version 1.3.0 installed for any length of time, it could have also rendered any other version up to 1.3.2 unusable. If you install 1.3.3 or higher, the slowdown will be fixed automatically by an update script. * content filters can't be applied to notes displayed on attachment pages and probably won't ever be unless someone pays me or figures out what is going on for me and sends a patch = Can I put notes on the public part of the site, or in a shortcode? = I recommend using http://wordpress.org/extend/plugins/wp-announcements/ for public notices. However, a shortcode is available for notes that are explicitly set to allow it. The shortcode can then used like so: [sitenote id='123'] If you only want to show one note, and none of its child notes, set the depth parameter to 0, for example: [sitenote id='123' depth='0'] You can also change 'sitenote' to something else by adding the following line to your functions.php: define('DSN_SHORTCODE','your_shortcode_name_here'); = I installed the plugin but I don't see anything! = They might be disabled for your role. Try going to Settings->Site Notes and make sure the box next to Administrator is checked. Also, make sure that note management hasn't been disabled (see below). = I've finished adding notes and now I want to hide the management of Site Notes. = Go to Settings->Site Notes and uncheck the box next to Administrator and they will no longer be editable. To re-enable them, just come back to this page and turn it back on. You can also add define('DSN_DISABLE_CHANGES',true); to your functions.php to disable all changes completely, but note that if you do that, NOBODY will be able to make any changes whatsoever until you remove that line. = Why isn't one of my notes showing up in the dashboard/instructions? = First, make sure that you've checked the checkbox for appearing in the appropriate place. If the note has a parent note, that parent must also be visible or else your note won't show up on the dashboard or in the instruction manual. Roles must also be selected; if you don't choose any roles, your note will not show up for anyone. = Why is one of my notes showing up with empty text? = Make sure that the excerpt field for your note is empty or contains the content you want to include. If it's still not showing up, trying disabling excerpt, excerpt filters, and/or content filters on the settings page. = What is planned for future versions? = 1.4 (mostly complete already, to be released sometime around May 2012): * can add notes to pretty much any admin location now * author names can be added to notes * note options 'hide title in widget', and 'hide title in shortcode' * added a bunch of hooks and filters so developers can interact with plugin without modifying it * notes are now sanitized so they're hopefully safe for non-admins to use * collapse/expansion of note boxes * update translations 1.5: * warning if a note is created that can't be seen anywhere or by anyone (no role or location selected) * add ability to show site note management pages for only specific user(s) instead of just by role * add ability to put notes in the admin bar * note featured images * refine capabilities management * Multisite features (add notes to all sites/specific sites) * add option for displaying an 'edit' link next to each note for users with appropriate permissions * add option for eliminating default wordpress contextual help (might be impossible right now due to lack of hooks - see wp-admin/includes/screen.php starting at 680) 1.6: Will probably never happen because there's not much further it could go without getting stupid. = Features that will not be implemented: = * expirations/time ranges - use http://wordpress.org/extend/plugins/automatic-page-publish-expire/ * make notes outside of admin - use shortcode or WP Announcements: http://wordpress.org/extend/plugins/wp-announcements/ == Screenshots == 1. Creating a site note (v1.2) 1. The dashboard widget that appears after notes are created there. (v1.2) 1. A note as it appears on the list/search page. (v1.2) 1. Generated instruction manual from notes (v1.2) 1. The options page (v1.2) == Changelog == = 1.3.3 = * bugfix: meta fields no longer cleared when doing a quick edit or bulk edit * bugfix: update automatically fixes any slowdown issues created by version 1.3.0 = 1.3.2 = * bugfix: fixed plugin upgrade script that caused site to grind to a halt = 1.3 = * feature: ability to add notes to the contextual help tab * feature: shortcode 'sitenote' or can be renamed with define('DSN_SHORTCODE','yourshortcode'); * feature: 'attachment' type now works on WP Media pages * feature: 'revision' type now works on WP revision page * feature: restructured so that plugin memory/cpu footprint on non-admin pages now extremely tiny * change: 'exclude from instructions' has been replaced with a new instruction manual location. existing notes updated on upgrade. * change: since contextual help tab is now a possible place to put notes, 'admin notice' has been added as a location instead of being assumed by default. existing notes updated on upgrade. * change: reorganized the add/edit site notes layout again since concepts keep changing. Sorry! * change: added some styles to attempt to standardize margin/padding notes when mixing plain text and html notes wrapped with paragraph tags * bugfix: notes now correctly display on basic 'post' content type * bugfix: on plugin upgrade, any useless meta fields that were accidentally created in some older versions are deleted = 1.2 = * added Italian (Italiano) and Dutch (Nederlands) translations * fixed some localization bugs * added jquery dependency to enqueue_script and moved it to admin_enqueue_scripts = 1.1 = * added constant for allowing normal admins to edit config on multisite * added constant for disabling all changes by anyone and hiding all our admin pages * css changes to make everything prettier and hopefully more usable * added config option for choosing which roles can create notes * added note option for hiding the title * added config option for enabling application of content filters on notes * added config option for enabling use of excerpts * added config option for title of dashboard widget and instruction manual * added config option for grouping notes * added options page * notes now sorted by 'menu_order' ascending, then by 'post_title' ascending = 1.0.1 = * fixed bug that was adding extra meta fields to wrong content types = 1.0 = * added instruction manual = 0.9.2.1 = * fixed fatal error bug and display bug * fixed incorrect screenshots = 0.9.2 = * added translation support and English .pot file * added donate links * hierarchy now takes effect on notes on dashboard * if excerpt is available, use that in notices/dashboard, with full text appearing only in manual * major optimization by changing note querying method and removing other stupidity * stored 'everywhere' checkboxes server-side so they work without javascript enabled * added GPLv3 license document * improved auto ("everywhere") checkbox functionality = 0.9.1 = * notes can be set to display only for certain user roles = 0.9 = * added post type notes by action * added dashboard notes == Upgrade Notice == = 1.1 = Added a bunch of configuration options, permissions options, a bit of css, and some minor bug fixes. MULTISITE USERS: this will add permission for normal admins (not just super-admins) to create site notes unless you go to Site Notes Config and disable the administrator permission. == Other Notes == = Acknowledgements = Thanks to Peter Luit for the Dutch translation and beta testing and thanks to anyone else who has found and reported bugs.