adi_notes – Leave notes for Textpattern users
This plugin gives you:
- new tabs under Home, Content, Presentation and Admin to present your pearls of wisdom
- public & private notes embedded in all Textpattern admin pages
- a tab under Extensions, to set up adi_notes
Installation of adi_notes adds a new table to your Textpattern database which should not interfere with anything else. That said, if you are of a cautious frame of mind then I can thoroughly recommend rss_admin_db_manager to do database backups before installation.
Once the plugin is installed and activated, go to its Options page and click “Install”.
Although a backup of your notes will be made during the upgrade process it is recommended that you make an independent copy as well.
When upgrading to version 1.3 or above, an attempt will be made to automatically convert custom styles into the new format – but it is advisable to take a copy of your existing style.
adi_notes admin tab
Users with sufficient privileges will see the adi_notes admin tab under Extensions. This gives you functionality to:
- toggle note tab visibility on/off
- set privilege levels of who can edit public notes
- set privilege levels of who can use TXP tags in their private notes
- change position of embedded notes
- change note styles
- choose between Textile or TinyMCE
Public & Private
Public notes are visible to all users but can only be added/edited by an Admin user (i.e. a user with sufficiently elevated privileges). Public notes can either be note tabs or embedded notes.
Private notes can be added by all users (including “Admin users”) but are only visible to the individual users. Private notes can only be embedded.
By default, “Admin users” are Publishers & Managing Editors. This may be changed in the adi_notes admin tab.
Notes can consist of anything that you can put in a article:
- textiled text
- HTML tags
- TXP tags
Tags will always be parsed in Note tabs and Public notes. The parsing of tags in private notes can be restricted according to privileges set in adi_notes admin.
If you want to use
<txp:php> tags then Allow PHP in pages? must be switched on in Preferences.
Note tabs will appear under Home, Content, Presentation or Admin depending on the visibility set in adi_notes admin. After installation, the Content Notes tab is switched on by default. If you make the Home note tab visible then the Home tab itself will automatically appear.
The Notes tabs are public, i.e. they will be visible to anyone who logs in to the Textpattern Admin interface.
Notes made in note tabs can only be edited by an “Admin” user.
Embedded notes are available in all Textpattern admin pages. They appear either at the top or at bottom of the page.
All users see public notes. Private notes are only visible to individual users.
Only “Admin” users can add & edit public notes. All users can add & edit their own private notes.
To use the TinyMCE WYSIWYG editor, you can install it:
- as part of the hak_tinymce plugin
adi_notes will detect if the hak_tinymce plugin is installed.
If you choose to install TinyMCE as a separate package then the path to the
tiny_mce directory must be specified (as a path relative to the textpattern subdirectory) – the default is ../scripts/tiny_mce, i.e. subdirectory scripts at the same level as textpattern.
Visit the adi_notes admin tab to see the various options.
Notes about adi_notes
- Uninstalling adi_notes from the plugin options page will delete all notes from the Textpattern database
- Note tab visibility simply controls whether the tabs can be seen in the specified areas. Notes that are not visible are not deleted, just hidden. Embedded notes are always visible, however they may be removed by deleting the note contents
- Add/Edit links will only be seen by those sufficiently elevated in the privilege department
- By default, notes are formatted using Textile (see above for TinyMCE support)
- Options that are set blank in the adi_notes admin tab (or in the case of privileges, all switched off) will revert to defaults
- The parsing of TXP tags in private notes can be controlled in Notes Admin
To install the Textpack, go to the plugin’s Options tab and click on “Install textpack”. This will copy & install it from a remote server. The number of language strings installed for your language will be displayed.
If the Textpack installation fails (possibly due to an error accessing the remote site), the alternative is to click the Textpack also available online link. This will take you to a website where the Textpack can be manually copied & pasted into the TXP Admin – Language tab.
Additions and corrections to the Textpack are welcome – please use the Textpack feedback form.