Location: PHPKode > scripts > Link Library > link-library/readme.txt
=== Link Library ===
Contributors: jackdewey
Donate link: http://yannickcorner.nayanna.biz/wordpress-plugins/link-library
Tags: link, list, directory, page, library, AJAX, RSS, feeds, inline, search, paging, add, submit, import, batch
Requires at least: 2.7
Tested up to: 3.5.1
Stable tag: trunk

The purpose of this plugin is to add the ability to output a list of link categories and a complete list of links with notes and descriptions.

== Description ==

This plugin is used to be able to create a page on your web site that will contain a list of all of the link categories that you have defined inside of the Links section of the Wordpress administration, along with all links defined in these categories. The user can select a sub-set of categories to be displayed or not displayed. Link Library also offers a mode where only one category is shown at a time, using AJAX or HTML Get queries to load other categories based on user input. It can display a search box and find results based on queries. It can also display a form to accept user submissions and allow the site administrator to moderate them before listing the new entries. Finally, it can generate an RSS feed for your link collection so that people can be aware of additions to your link library.

For links that carry RSS feed information, Link Library can display a preview of the latest feed items inline with the all links or in a separate preview window.

This plugin uses the filter method to add contents to the pages. It also contains a configuration page under the admin tools to be able to configure all outputs. This page allows for an unlimited number of different configurations to be created to display links on different pages of a Wordpress site.

You can see a few examples of pages using Link Library on my personal site:

* [Library in table form with search box and link submission form](http://yannickcorner.nayanna.biz/freeware-database/)
* [Library in unordered list form with RSS feed icons](http://yannickcorner.nayanna.biz/favorite-links/)
* [Library in unordered list form with RSS feed icons and Pagination](http://yannickcorner.nayanna.biz/links-page-with-pagination/)
* [Library only showing one category at a time through AJAX queries](http://yannickcorner.nayanna.biz/freeware-database-ajax-version/)
* [Library in unordered list form with 1 full RSS item per feed inline and 5 RSS item full previews when selecting preview icon](http://yannickcorner.nayanna.biz/links-page-with-preview/)
* [RSS Feed generated by Link Library for Freeware Database](http://yannickcorner.nayanna.biz/wp-content/plugins/link-library/rssfeed.php?settingset=1)

For screenshots showing how to achieve these results, check out my [site](http://yannickcorner.nayanna.biz/wordpress-plugins/link-library)

Examples from actual users can be found on my [site](http://yannickcorner.nayanna.biz/wordpress-plugins/link-library/link-library-usage-examples/).

All pages are generated using different configurations all managed by Link Library. Link Library is compatible with the [My Link Order](http://wordpress.org/extend/plugins/my-link-order/) plugin to define category and link ordering.

* [Changelog](http://wordpress.org/extend/plugins/link-library/other_notes/)
* [Support Forum](http://wordpress.org/tags/link-library)

== Installation ==

1. Download the plugin
1. Upload link-library.php to the /wp-content/plugins/ directory
1. Activate the plugin in the Wordpress Admin

To get a basic Link Library list showing on one of your Wordpress pages:<br />
1. In the Wordpress Admin, create a new page and type the following text, where # should be replaced by the Settings Set number:<br />
   [link-library settings=#]
   
1. To add a list of categories to jump to a certain point in the list, add the following text to your page:<br />
   [link-library-cats settings=#]<br />
   
1. To add a search box to your Link Library list, add the following text to your page:<br />
   [link-library-search]
   
1. To add a form for users to be able to submit new links:<br />
   [link-library-addlink settings=#]
   
In addition to specifying a library, categories to be displayed can be specified using addition keywords. Read the FAQ for more information on this topic.
   
Further configuration is available under the Link Library Settings panel.

== Changelog ==

= 5.7.9.4 =
* Fixed bug with large description field not getting saved when users submit links

= 5.7.9.3 =
* Corrected undefined method errors when users submitted new links

= 5.7.9.2 =
* Fixed wp_set_link_cat error when user submission option is active
* Fixed problem with links extra info table not getting created in new installations

= 5.7.9.1 =
* Fixed javascript error on add new link page

= 5.7.9 =
* Fix for error submitting links in 5.7.8

= 5.7.8 =
* Fixed error with unknown column when selecting List Featured Links ahead of Regular Links options

= 5.7.7 =
* Cleanup to avoid PHP warnings when some variables don't exist
* Support for plugin being located in a non-standard location
* Addition on uninstall scripts to delete extra table and settings on plugin deletion
* Thanks to Juliette Reinders Folmer for identifying all these issues
* Split code from admin in separate file to improve load times

= 5.7.6 =
* Added option in general settings to select if images that are uploaded or generated should be stored using their full path (functionality in 5.7.3 or older) or relative paths

= 5.7.5 =
* Fixed issue around category name div tags in list

= 5.7.4 =
* Changed stored URL for uploaded images to use relative paths

= 5.7.3 =
* Fixed bug in on-demand thumbnail generation

= 5.7.2 =
* Added div around Thumbshots notice to allow paying users to hide notice (free users need to keep notice displayed to avoid being banned by service)

= 5.7.1 =
* Fixed issue with Thumbshots CID having non-url compliant characters

= 5.7 =
* Re-worked Thumbshots integration to comply with new terms of use
* Updated french translation

= 5.6.9 =
* Added option to load styling on all pages with keyword 'all'

= 5.6.8 =
* Corrected error from version 5.6.7

= 5.6.7 =
* Added option to load styling on category pages with keyword 'category'

= 5.6.6 =
* Added option to load styling on front page with keyword 'front'

= 5.6.5 =
* Adds a div class to category names for styling

= 5.6.4 =
* Added new option so that no category is shown in AJAX mode until the visitor selects a category

= 5.6.3 =
* Re-implemented changes from version 5.6.1

= 5.6.2 =
* Rolled back changes

= 5.6.1 =
* Corrected problem with two undefined variables

= 5.6 =
* Added count of links to moderate in top-level Link Library menu item
* Added dashboard widget to display count of links to moderate

= 5.5.9.1 =
* Changed WP 3.5 support code to force presence of Link Manager if Link Library is installed and activated

= 5.5.9 =
* Removed check for presence of Link Manager in versions older than 3.5

= 5.5.8 =
* Added check for presence of Link Manager to support version 3.5 where the link manager will be inactive by default

= 5.5.7 =
* Added codes in pop-up content to display link rating and rss link

= 5.5.6 =
* Fixed link visit tracking code

= 5.5.5 =
* Added codes in pop-up content to display link submitter, link alternate URL and number of visits

= 5.5.4 =
* Attached popup to image and link name instead of only link name, when configured

= 5.5.3 =
* Added code in pop-up content to display link description, link large description, telephone number and e-mail
* Added pop-up configuration options to specify width and height

= 5.5.2 =
* Updated link popup mechanism to use link target information

= 5.5.1 =
* Added support to convert [ and ] to < and > in large description fields

= 5.5 =
* Added new option to display a popup with user-defined content when links are clicked, then present user with link to click through
* Updated danish translation

= 5.4.9.5 =
* Fixed problem with category links not going to the correct results page when pagination is turned on

= 5.4.9.4 =
* Fixed problem with nofollow and featured item check boxed not unchecking properly

= 5.4.9.3 =
* Fixed problem with e-mail notification when user-submitted links were received

= 5.4.9.2 =
* Correction to bad site admin path in e-mail notification

= 5.4.9.1 =
* Changes method used to build paths to images and other plugin files
* Fixed reciprocal link checker

= 5.4.9 =
* Removed previous affiliate link and added information on my upcoming book.

= 5.4.8 =
* Reverted all changes made in version 5.4.7 to remove undefined variable warnings

= 5.4.7 =
* Fixed undefined variable warnings, which showed up when WP_DEBUG was activated

= 5.4.6 =
* Clearly identified affiliate link in user interface
* Made affiliate image local to plugin

= 5.4.5 =
* Fixed problem with Link ID missing on some installations from links in moderation page

= 5.4.4 =
* Updated danish translation

= 5.4.3 =
* Cleanup to avoid PHP debug warnings

= 5.4.2 =
* Fixed problem with library switching logic

= 5.4.1 =
* Fixed path to plugin icon file

= 5.4 =
* Redesigned user submission processing code to send post data to external php file and redirect back after data storage and validation

= 5.3.3 = 
* Fixed duplicate check on user-submitted links
* Fixed problem with other plugins causing shortcode to be evaluated multiple times, resulting in multiple links submission

= 5.3.2 =
* Updated meta box creation code to be compatible with WordPress 3.3

= 5.3.1 =
* Added option to specify address for search box results. This allow you to place search box on one page and results on another page.
* Updated French translation
* Updated Italian translation
* Added Turkish translation

= 5.3 =
* Fixed way that messages were displayed when using user submission form
* Added error message when submitting a link without an address

= 5.2.9 =
* Updated Italian translation
* Updated French translation
* Added missing translation

= 5.2.8 =
* Updated translation file to add text for new option introduced in 5.2.7

= 5.2.7 =
* Added option to replace image with link name if no image is assigned to a link

= 5.2.6 =
* Added missing translation for UI element

= 5.2.5 =
* Split a sentence in two full pieces to facilitate translation.

= 5.2.4 =
* Fixed glitch with reciprocal check menu item disappearing

= 5.2.3 =
* Added italian translation (Thanks to Gianni Diurno!)
* Fixed some text strings which could not be translated

= 5.2.2 =
* Added check for search parameters to verify that they are only text or numbers

= 5.2.1 =
* Added an option to display link category list on search results page

= 5.2 =
* Added span tag to link category description to allow for styling

= 5.1.9 =
* Fixed updated date mechanism

= 5.1.8 =
* Removed debug code in link moderation screen
* Fixed problem with empty categories not showing up even if Hide when empty is not checked

= 5.1.7 =
* Fixed problem with category drop-down in user-submission form that prevented it from appearing in some situations
* Added data type validation code to avoid security exploits

= 5.1.6 =
* Corrected problem with link moderation list screen

= 5.1.5 =
* Corrected a problem with new link submission in admin editor

= 5.1.4 =
* Removed extra debugging code

= 5.1.3 =
* Added new sort mode to display links based on updated date
* Added field to links editor to see updated date and be able to manually change it

= 5.1.2 =
* Changed RSS parsing library back to Simplepie, but using version supplied with Wordpress with extra layer

= 5.1.1 =
* Corrected plugin installation function to properly create custom tables in multi-site environment
* Replaced SimplePie with PHP_RSS library to avoid PHP5 validation errors and have simpler code base

= 5.1.0 =
* Correct path for RSS Icon and RSS Preview Icons

= 5.0.9 =
* Security fix

= 5.0.8 =
* Fixed RSS Feed generation code to accept https links

= 5.0.7 =
* Added details on use of catogory list in link submission form
* Now using Moderator E-mail (if present) as destination address for moderation notifications

= 5.0.6 =
* Fixed problem with path of images uploaded for links

= 5.0.5 =
* Added option in reciprocal checker to delete links that return a 403 error during check

= 5.0.4 =
* Made code change to always load jQuery as soon as Link Library is rendered on a site to enable link click tracking
= 5.0.3 =
* Changed link id field to contain text before their numeric ID to be xhtml compliant
* Added code to strip slashes on custom fields in link editor
* Added link category to link moderation screen
* Add option to use textarea instead of input field for link notes in user submission form
* Added check in Reciprocal checked to see if site is dead. Display appropriate message if it is.

= 5.0.2 =
* Corrected a problem where slashes were getting added in front of quote and apostrophes when editing large description
= 5.0.1 =
* Added code to escape special characters in large description field when importing links

= 5.0 =
* Added new mode to show link categories in a drop-down list
* Replaced calls to wp_specialchars with esc_html since the previous function was deprecated in WP 2.8
* Corrected bad CSS styling in admin sections
* Added bookmarklet creation section in admin to allow for quick link creation
* Fixed problem where settings became "sticky" until you went out of plugin admin and came back after resetting them

= 4.9.8 =
* Tested with Wordpress 3.2
* Added missing tooltip for URL submission acknowledgement page

= 4.9.7 =
* Highlight the search result string if found in large description

= 4.9.6 =
* Added Large Description field to link search

= 4.9.5 =
* Added call to strip slashes off the large description field when displayed

= 4.9.4 =
* Corrected bug with extrainfo table creation code

= 4.9.3 =
* Added missing field to table creation code for new users

= 4.9.2 =
* Added ability for user link submissions to accept large descriptions

= 4.9.1 =
* Changed terminology from Setting Set to Library Settings or Library to make it more obvious to new users

= 4.9 =
* Added new div around each category output
* Added new featured link check box under link editor along with featured link sorting option in setting set configuration

= 4.8.5 =
* Fix to accept more than one link without a URL

= 4.8.4 =
* Fixed bug which delete all custom field data when generating thumbnails

= 4.8.3 =
* Fixed broken 2.9.2 compatibility issue introduced in version 4.8.2

= 4.8.2 =
* Changed table name creation from using prefix to get_blog_prefix() to be compatible with network sites

= 4.8.1 =
* Removed some unnecessary colorbox code
* Added option to allow users to submit a link without a url into the database

= 4.8 =
* Switched RSS Preview from using colorbox to thickbox since thickbox is delivered with Wordpress, simplifying compatibility
* Validated support with final version of Wordpress 3.1

= 4.7.5 =
* Fixed: Now stripping slashes in user link submission form if user does not enter captcha or some informations correctly when data is re-displayed in the fields.

= 4.7.4 =
* Fixed problem with large description not being saved when a link is first submitted or first modified
* Added ability to specify large description and no follow property in link importer

= 4.7.3 =
* Added reciprocal link checker

= 4.7.2 =
* Renamed tooltip class in admin to avoid conflict with other plugins (UAM in specific)
* Changed default number of stylesets to 1 to make plugin easier to use for newcomers
* Fixed problem with link name before code not showing up when secondary link was selected

= 4.7.1 =
* Maintenance and removal of old information on plugin page

= 4.7 =
* Added: Option to set nofollow property on links on a link-by-link basis

= 4.6.7 =
* Fixed: Problem with favicon generation in link editor page
* Fixed: Problem with content directory location when user redirects it
* Fixed: Web Link not following target rules

= 4.6.6 =
* Fixed: Direct references to content upload directory which did not work in network configurations

= 4.6.5 =
* Fixed: Pagination issues

= 4.6.4 =
* Fixed: Unable to hide submitter name and e-mail fields

= 4.6.3 =
* Fixed: Problem with link submission when no captcha is displayed
* Fixed: Custom captcha show/hide setting not saved

= 4.6.2 =
* Fixed: Only Settings Set up to 5 could be accessed since version 4.5
* Fixed: First part of submitter was not properly parsed when sending user confirmation e-mail

= 4.6.1 =
* Fixed: Missing some fields for new installations

= 4.6 =
* Added: New configuration section under General Settings for Moderation Options
* Added: Ability to send approval or refusal messages to new link submitters
* Added: Option to customize title of moderation notification e-mail
* Added: Ability to specify custom captcha question
* Added: New field to store large link descriptions in link editor page
* Added: CSS Class for User Link Submit button
* Added: Ability to specify custom URL to redirect after user submission

= 4.5.8 =
* Added: Code to remove link tags from links that have a hash sign as their address (#)

= 4.5.7 =
* Fixed: Error about ll_install function not found for users upgrading from older versions

= 4.5.6 =
* Fixed: RSS Link using Standard Icon did not use correct address

= 4.5.5 =
* Added: Icon for plugin menu in Wordpress Admin
* Fixed: Edit link for admins now points to correct URL
* Fixed: Link to stylesheet editor on general settings page
* Fixed: Re-arranged some code section for compatibility with older versions of PHP

= 4.5.4 =
* Changed directory for image upload and thumbnail generation to be under \wp-content\uploads instead of plugins directory

= 4.5.3 =
* Added: New Manual Image Upload field in link edition form

= 4.5.2 =
* Fixed: Headers already sent error when pressing update settings button on settings set window
* Fixed: Added back second save button at bottom of Settings Set section
* Fixed: Messages get variable that was repeating on settings set page
* Fixed: Unable to hide Link Name
* Fixed: Non-translable string in e-mail notification template

= 4.5.1 =
* Fixed: Changed registration method for actions to avoid problem on some installations of Wordpress
* Added: New notification icon on moderate section to indicate if any links need to be moderated
* Updated french and danish translations

= 4.5 =
* Redesign of the admin pages and restructuring of entire code base
* Admin section now has its own menu section with sub-sections instead of being located under settings
* Ability to hide sections of admin pages using the screen options Wordpress tab at the top of each admin page

= 4.3.3 =
* Fixed: Drag-and-drop for link element ordering

= 4.3.2 =
* Added: Link Rating is now part of the Link Sub-Field Configuration table to be displayed and configured
* Fixed: Slow load in IE caused by fancybox. Switched to colorbox for RSS Preview box.
* Fixed: Potential conflicts between jQuery sortable query delivered with Link Library and version included with Wordpress
* Added: French translation of Captcha elements
* Added: Check for duplicate link URL and names upon user submission
* Fixed: Links in moderation screen now correctly let you view link edit pages

= 4.3.1 =
* Change captcha library from re-captcha to library included with plugin to fix layout issues

= 4.3 =
* Added: Captcha option for user link submission form (uses Re-Captcha service)
* Fixed: MySQL error message displayed on some installations when creating new links

= 4.2.9.1 =
* Re-added: Extra field in link import template for link image address

= 4.2.9 =
* Re-fixed: Problem with too many AJAX queries in a short period of time in Internet Explorer
* Re-fixed: Paging in AJAX mode when showing one category at a time
* Re-added: Ability to specify link image address when batch importing

= 4.2.8 =
* Rolling back all changes to version 4.2.5. The new features of 4.2.6 will be re-implemented this week-end and tested more thoroughly.

= 4.2.7=
* Reverted changes related to WP 3.0 network compatibility to fix errors experienced by many users

= 4.2.6 =
* Added: WP 3.0 Network Compatibility
* Fixed: Problem with too many AJAX queries in a short period of time in Internet Explorer
* Fixed: Paging in AJAX mode when showing one category at a time
* Added: Ability to specify link image address when batch importing

= 4.2.5 =
* Added: New sorting order for links to be displayed in random order
* Added: New option to limit number of links displayed per category
* Fixed: Stylesheet no longer disappears when saving general settings
* Fixed: Thumbshots CID now works correctly for dynamic thumbnail generation
* Fixed: Error messages that were appearing on AJAX load and a few other section have been removed

= 4.2.4 =
* Added fix for strict PHP errors that may appear on RSS Preview on some server configurations
* Fixed display of thumbshots cid field
* Fixed retrieval of thumbnails from thumbshots.ord when user CID provided

= 4.2.2 =
* Fixed problem with escape characters added to stylesheet editor when double-quote are present

= 4.2.1 =
* Added missing code for translation of edit link

= 4.2 =
* Fix for RSS dialog box images not showing up in Internet Explorer
* Fix to properly pass thumbshots CID when requested thumbnails

= 4.1.8 =
* Improved usage instructions section

= 4.1.7 =
* Improved thumbnail and favorite icon generation buttons in link edition form so that they work even when creating a new link and don't redirect to a different page

= 4.1.6 =
* Fixed: Use primary web address if plugin is updated and settings are not saved anew.

= 4.1.5 =
* Fixed: Show Web Hits option now turns off correctly

= 4.1.4 =
* Fixed: Edit links where broken in 4.0. Image and Link ids were broken in 4.0.

= 4.1.3 =
* Fixed: Links not displayed when links ordered by ID
* Improved upgrade process from versions before 4.0 to avoid losing configuration options.

= 4.1.2 =
* Correction to stylesheet display filter

= 4.1.1 =
* Minor tweaks to stylesheet editor

= 4.1 =
* Added: Stylesheet Editor to avoid upgrade issues with customized stylesheet getting overwritten.

= 4.0.4 =
* Update: French translation corrections

= 4.0.3 =
* Fixed: Added replacement statement to convert double-quotes to single quotes in text fields.

= 4.0.2 =
* Fixed: Only search results from first category encountered would display when only showing one category at a time

= 4.0.1 =
* Fixed: Problem with batch thumbnail generation, files not created in right folder

= 4.0 =
* Added: New drag-and-drop interface to specify order of link elements
* Added: Ability to specify target link for link categories to allow categories to be on seperate page from link library
* Added: New section in link edition screen to specify new data elements (Reciprocal Link, E-mail, Second Web Address, Telephone, Link Submitter)
* Added: Ability to batch import links through csv files
* Added: Ability to import/export setting sets using csv files
* Added: Collection of click-through stats for links
* Added: Link category permalinks
* Added: Update page title
* Added: French Translation
* Added: Can now generate thumbnail or favorite icon or a single-link basis
* Added: Option to store user information when available upon link submission

= 3.4 =
* Addition correction for link count in category listing

= 3.3.9 =
* Corrected link count in category listing to disregard hidden links is Show Hidden option is disabled

= 3.3.8 =
* Removed unnecessary call to load jquery-ui since that file does not exist.

= 3.3.7 =
* Remove unnecessary function that caused problems with some themes which defined a function with the same name

= 3.3.6 =
* Fixed: Added check for links per page config setting being set to 0 or null when pagination mode is active

= 3.3.5 =
* Fixed: Problem with AJAX category switching when setting set # not specified in Link Library shortcode

= 3.3.4 =
* Fixed: Error with undefined function initTree when using AJAX category switching

= 3.3.3 =
* User-submitted links under moderation are now set to be invisible. Their visibility is set to true when they are approved.

= 3.3.2 =
* Added: Field in admin page to customize label in search form

= 3.3.1 =
* Fixed: Removed hard-coded site path when clicking on links on moderation page
* Added: Label for user-submitted category list entry

= 3.3 =
* Added: New debug information for category list in add link form
* Fixed: Problem with population of category list in Link Addition Form
* Added: Ability for users to submit new category when submitting new links

= 3.2.9 =
* Fixed: Dimensions of RSS Preview Window
* Fixed: Population of category list in Link Addition Form

= 3.2.8 =
* Fixed: Repeating category headers on certain configurations

= 3.2.7 =
* Fixed: Highlight bugs in search results

= 3.2.6 =
* Enhanced link moderation page layout

= 3.2.5 =
* Fixed: Thumbnail generation now works all the time instead of only when specific categories are specified

= 3.2.4 =
* Fixed: Gaps between admin form sections no longer appear after updating settings.

= 3.2.3 =
* Fixed: A href tags placed within link notes are now rendered correctly as links again

= 3.2.2 =
* Corrected bug with new link moderation section that caused errors on servers without the php open short tag option enabled

= 3.2.1 =
* Changed format of if statement to switch between admin and moderation to avoid problem with some server configurations
* Added support for single quotes in link sub-field configuration table

= 3.2 =
* Added new link moderation screen that allows for batch approval or deletion of links awaiting moderation

= 3.1.7 =
* Changed option "Use HTML codes for formatting" to "Convert [] to <> in Link Description and Notes" since Wordpress does not allow admins to put HTML tags in notes and description

= 3.1.6 =
* Changed tooltip plugin used in admin pages to avoid conflict with other plugins

= 3.1.5 =
* Fixed: Category links not working correctly with pagination turned on

= 3.1.4 =
* Fixed: Problem with show one category at a time in AJAX mode after upgrade
* Tested compatibility with Wordpress 3.0 Beta 1. No problems to report.

= 3.1.3 =
* Upgraded version of fancybox plugin 1.3.1

= 3.1.2 =
* New Feature: Generate images for links from web site fav icons
* Fixed: Thumbnail generation now only happens once when you press the button instead of every time you press submit after the initial generation

= 3.1.1 =
* Fixed: Get errors when saving settings referring to an empty category
* Fixed: When showing one category at a time and selecting an empty category, categories with links stop showing the links that they contain

= 3.1 =
* Added ability to generate RSS feeds for a link page.
* Added new option to show single categories using AJAX (previous mode) or HTML GET methods

= 3.0.4 =
* Added new option to display number of links for each category in the category list

= 3.0.3 =
* Fix to display tooltips in admin pages
* Added information to readme

= 3.0.2 =
* Corrected bug with link search when using the AJAX Show One Category at a Time mode

= 3.0.1 =
* Removed doubel highlight tags when displaying search results
* Fix problem with category links when pagination mode is active and category is displayed on page other than first
* Added new option to only display link addition form when logged in as a valid user

= 3.0 =
* Added e-mail notification when new links are submitted
* Removed text color tags from default stylesheet
* Added new options to specify which fields should be displayed on Link Addition form (Show/Hide)
* Added option to use site thumbnails instead of local images
* Added new button to request and store thumbnails for all links

= 2.9.3 =
* Resolved further issues when both "Paginate Results" and "Only show one category at a time" are activated
* Enhanced debugging mode

= 2.9.2 =
* Fix refresh problem in Link Library admin page when updating settings
* Enabled "Paginate Results" and "Only show one category at a time" options to work together
* Removed possibility of upgrading settings from a pre-2.0 version of Link Library

= 2.9.1 =
* Fixes problem with infinite loop introduced in version 2.8.8 and higher

= 2.9 =
* Added new option field to specify class for link images
* Added debug mode to facilitate remote debugging

= 2.8.9 =
* Corrected small bug withcheck to determine if stylesheet should be loaded

= 2.8.8 =
* Added built-in support to store link update time instead of having to rely on external plugins
* Improved filtering system to decide which plugins/stylesheets get loaded on a page based on its contents and configuration

= 2.8.7 =
* Add new option to specify position of image relative to link name (before or after)
* Added option to include scripts and stylesheets on specific pages even if they don't contain the Link Library shortcode commands

= 2.8.6 =
* Move code to process user submitted links from Link Display code to Link Submission Form code to allow link submission form to be displayed on different page than links

= 2.8.5 =
* Small correction so that edit link shows up next to link name

= 2.8.4 =
* Added ability to specify code to be placed before and after link images

= 2.8.3 =
* Restored div ids based on setting set number to allow multiple link libraries to be displayed on the same page
* Changed AJAX loading indicator from being displayed in a span to a div
* Changed text displayed when no categories or no links are displayed to be simpler

= 2.8.2 =
* Fixed problem with AJAX mode when switching categories
* Changes names of categories to full name in user submission form
* Fixes problem with categories showing with no link if unapproved links were present in database

= 2.8.1 =
* Corrected a few bugs with listing categories in user submission form
* Made small enhancements to stylesheet

= 2.8 =
* Corrects problem with bad link results introduced in version 2.7.1
* Add ability to have more than 5 Settings Set

= 2.7.2 =
* Correctly process special characters in category description

= 2.7.1 =
* Fixed option "Hide if Empty" to correctly display categories that do not contain any links
* Improved the pagination scheme that was introduced in version 2.7 to show a limited number of entries

= 2.7 =
* Changed jQuery script to render RSS previews from Thickbox to Fancybox
* Added code to check if javascript and stylesheets from plugin are necessary before loading them
* Changed pagination system to show all pages and allow user to navigate though link library pages quicker
* Fixes stylesheet bugs in Link-Library.css. CSS issues with Thickbox were removed by changing jQuery scrip for that functionality

= 2.6.1 =
* Now correctly displays link dates if that functionality is activated

= 2.6 =
* Adds the ability to display a form for users to submit new links to the Wordpress link database
* Allows administrators to determine if links are displayed immediately or only after being moderated
* All labels can be edited in the admin panel

= 2.5.9.3 =
* Corrected a big with category names appearing twice after update 2.5.9.2

= 2.5.9.2 =
* Added option to specify category description position relative to category name
* Added new option to display link date between link name and description

= 2.5.9.1 =
* Modified code only to display table column headers if they contain text

= 2.5.9 =
* Stopped showing links sets as private by default
* Added option to show links even if they are hidden (false by default)

= 2.5.8 =
* Modified search and pagination features to work with Permalinks config set to Default

= 2.5.6 =
* Corrected bug with Ajax loading icon not disappearing after data is loaded
* Added fix so that the notes and description outout can be correctly hidden if desired.

= 2.5.5 =
* Corrected bug with Show Edit Links option in admin panel
* Fixed issue with AJAX mode (Show one category at a time) where page would always go back to top when clicking on category links

= 2.5.4 =
* Added new general options section for settings that apply to all configuration
* Added field to specify custom stylesheet name to avoid getting your settings overridden with each update

= 2.5.3 =
* Corrects bug in Ajax mode (display one category at a time) when two instances of Link Library are displayed on the same page
* Corrects bug in admin page for new option to show/hide category names. Also renamed from Show Category Names to Hide Category Names

= 2.5.2 = 
* Bug fix to make Link Library accessible from Plugins Page
* Corrected path to jquery plugin

= 2.5.1 =
* Fixed bug with One Category at a time mode if no default category is set

= 2.5 =
* Redesigned administration panel
* Moved configuration settings under Settings section in Wordpress admin
* Added new ability to display search box and highlight keywords in results
* Added new ability to limit number of results per page and add links to navigate between pages

= 2.3.3 =
* Fixed bug with AJAX mode to display one category at a time

= 2.3.2 =
* Fixed bug with RSS feeds which tried to load RSS feeds even if no feed address was specified

= 2.3.1 =
* Added configuration field to specify RSS library cache directory. Had been hard-coded by error in version 2.3

= 2.3 =
* Added messages in admin panel to show that data is saved or potential errors.
* Added new ability to show RSS feed previews in a preview box or inline with links.

= 2.2 =
* Added new mode that only shows one category at a time.
* New category can be selected through category list.
* Default first category can be selected by user.
* Uses AJAX to fetch data.

= 2.1 =
* Added ability to display edit links next to links in page for editors and administrators that are logged in.

= 2.0 =
* Added ability to define multiple groups of settings to use Link Library on different pages with different configurations.

= 1.3.2 =
* Added option to display link category descriptions, with option to embed HTML code in description.

= 1.3.1 =
* Optimized some of the code for category parsing and corrected a few syntax errors.
* Categories with special characters will also be handled better.

= 1.3 =
* Created a new stylesheet for Link Library styles. Added new reset settings link for a table layout.

= 1.2.5 =
* Adds new option to specify a target window for all links

= 1.2.4 =
* Corrects second issue related to exclusion list and category order set to included list

= 1.2.3=
* Corrects a bug between the exclusion list and setting category order to included list with no included list defined

= 1.2.2 =
* Correct a few issues with escape characters and the nofollow condition

= 1.2 =
* Added new options to output extra code before and after complete link groups after a user-defined number of links.
* Enables the display of links are data cells in a table row.

= 1.1.9 =
* Added new option to show RSS link using standard icon instead of only textual link.

= 1.1.8.1 =
* Fixed bug with Show Image and Name option. Now works as expected.

= 1.1.8 =
* Added new ordering option to follow order set by [My Link Order](http://wordpress.org/extend/plugins/my-link-order/) plugin

= 1.1.7 = 
* Added new options to give users flexibility to choose between div class tags and heading tags.
* Users upgrading need to select the desired output and set the value of the class name (e.g. linklistcatname) or desired heading style (e.g. h2).

= 1.1.6 =
* The H2 tags that were previously placed before and after the names of the link categories have been replaced by a div class called linklistcatname.
* This allows for more flexibility in formatting the element using your blog�s stylesheet.

== Frequently Asked Questions ==

= Where do I find my category IDs to place in the "Categories to be Displayed" and "Categories to be Excluded" fields? =

The category IDs are numeric IDs. You can find them by going to the page to see and edit link categories, then placing your mouse over a category and seeing its numeric ID in the link that is associated with that name.

= How can I display different categories on different pages? =

If you want all of your link pages to have the same layout, create a single setting set, then specify the category to be displayed when you add the short code to each page. For example: [link-library categorylistoverride="28"]
If the different pages have different styles for different categories, then you should create distinct setting sets for each page and set the categories to be displayed in the "Categories to be Displayed" field in the admin panel.

= After assigning a Link Acknowledgement URL, why do links no longer get added to my database? =

When using this option, the short code [link-library-addlinkcustommsg] should be placed on the destination page.

= How can I override some of the options when using shortcodes in my pages =

To override the settings specified inside of the plugin settings page, the two commands can be called with options. Here is the syntax to call these options:

[link-library-cats categorylistoverride="28"]

Overrides the list of categories to be displayed in the category list

[link-library-cats excludecategoryoverride="28"]

Overrides the list of categories to be excluded in the category list

[link-library categorylistoverride="28"]

Overrides the list of categories to be displayed in the link list

[link-library excludecategoryoverride="28"]

Overrides the list of categories to be excluded in the link list

[link-library notesoverride=0]

Set to 0 or 1 to display or not display link notes

[link-library descoverride=0]

Set to 0 or 1 to display or not display link descriptions

[link-library rssoverride=0]

Set to 0 or 1 to display or not display rss information

[link-library tableoverride=0]

Set to 0 or 1 to display links in an unordered list or a table.

= Can Link Library be used as before by calling PHP functions? =

For legacy users of Link Library (pre-1.0), it is still possible to call the back-end functions of the plugin from PHP code to display the contents of your library directly from a page template.

The main differences are that the function names have been changed to reflect the plugin name. However, the parameters are compatible with the previous function, with a few additions having been made. Also, it is important to note that the function does not output the Link Library content by themselves as they did. You now need to print the return value of these functions, which can be simply done with the echo command. Finally, it is possible to call these PHP functions with a single argument ('AdminSettings1', 'AdminSettings2', 'AdminSettings3', 'AdminSettings4' or 'AdminSettings5') so that the settings defined in the Admin section are used.

Here would be the installation procedure:

1. Download the plugin
1. Upload link-library.php to the /wp-content/plugins/ directory
1. Activate the plugin in the Wordpress Admin
1. Use the following functions in a [new template](http://codex.wordpress.org/Pages#Page_Templates) and select this template for your page that should display your Link Library.

`&lt;?php echo $my_link_library_plugin->LinkLibraryCategories('name', 1, 100, 3, 1, 0, '', '', '', false, '', ''); ?&gt;<br />
`&lt;br /&gt;<br />
&lt;?php echo $my_link_library_plugin->LinkLibrary('name', 1, 1, 1, 1, 0, 0, '', 0, 0, 1, 1, '&lt;td>', '&lt;/td&gt;', 1, '', '&lt;tr&gt;', '&lt;/tr&gt;', '&lt;td&gt;', '&lt;/td&gt;', 1, '&lt;td&gt;', '&lt;/td&gt;', 1, "Application", "Description", "Similar to", 1, '', '', '', false, 'linklistcatname', false, 0, null, null, null, false, false, false, false, '', ''); ?&gt;

=function LinkLibraryCategories()=

 Output a list of all links categories, listed by category, using the settings in $wpdb->linkcategories and output it as table

 Parameters:<br/>
   order (default 'name')  - Sort link categories by 'name', 'id', 'catlist'. When set to 'AdminSettings', will use parameters set in Admin Settings Panel.<br/>
   hideifempty (default true)  - Supress listing empty link categories<br/>
   tablewitdh (default 100) - Width of table, percentage<br/>
   numcolumns (default 1) - Number of columns in table<br/>
   catanchor (default false) - Determines if links to generated anchors should be created<br/>
   flatlist (default false) - When set to true, displays an unordered list instead of a table<br/>
   categorylist (default null) - Specifies a comma-separate list of the only categories that should be displayed<br/>
   excludecategorylist (default null) - Specifies a comma-separate list of the categories that should not be displayed<br/>
   showcategorydescheaders (default null) - Show category descriptions in category list<br/>
   showonecatonly (default false) - Enable AJAX mode showing only one category at a time<br/>
   settings (default NULL) - Settings Set ID, only used when showonecatonly is true<br/>
   loadingicon (default NULL) - Path to icon to display when only show one category at a time<br/>

=function LinkLibrary()=

 Output a list of all links, listed by category, using the settings in $wpdb->linkcategories and output it as a nested HTML unordered list. Can also insert anchors for categories

 Parameters:<br/>
   order (default 'name')  - Sort link categories by 'name', 'id' or 'catlist'. When set to 'AdminSettings', will use parameters set in Admin Settings Panel.<br/>
   hideifempty (default true)  - Supress listing empty link categories<br/>
   catanchor (default false) - Adds name anchors to categorie links to be able to link directly to categories<br/>
   showdescription (default false) - Displays link descriptions. Added for 2.1 since link categories no longer have this setting<br/>
   shownotes (default false) - Shows notes in addition to description for links (useful since notes field is larger than description)<br/>
   showrating (default false) - Displays link ratings. Added for 2.1 since link categories no longer have this setting<br/>
   showupdated (default false) - Displays link updated date. Added for 2.1 since link categories no longer have this setting<br/>
   categorylist (default null) - Only show links inside of selected categories. Enter category numbers in a string separated by commas<br/>
   showimages (default false) - Displays link images. Added for 2.1 since link categories no longer have this setting<br/>
   showimageandname (default false) - Show both image and name instead of only one or the other<br/>
   usehtmltags (default false) - Use HTML tags for formatting instead of just displaying them<br/>
   showrss (default false) - Display RSS URI if available in link description<br/>
   beforenote (default &lt;br /&gt;) - Code to print out between the description and notes<br/>
   nofollow (default false) - Adds nofollow tag to outgoing links<br/>
   excludecategorylist (default null) - Specifies a comma-separate list of the categories that should not be displayed<br/>
   afternote (default null) - Code / Text to be displayed after note<br/>
   beforeitem (default null) - Code / Text to be displayed before item<br/>
   afteritem (default null) - Code / Text to be displayed after item<br/>
   beforedesc (default null) - Code / Text to be displayed before description<br/>
   afterdesc (default null) - Code / Text to be displayed after description<br/>
   displayastable (default false) - Display lists of links as a table (when true) or as an unordered list (when false)<br/>
   beforelink (default null) - Code / Text to be displayed before link<br/>
   afterlink (default null) - Code / Text to be displayed after link<br/>
   showcolumnheaders (default false) - Show column headers if rendering in table mode<br/>
   linkheader (default null) - Text to be shown in link column when displaying as table<br/>
   descheader (default null) - Text to be shown in desc column when displaying as table<br/>
   notesheader (default null) - Text to be shown in notes column when displaying as table<br/>
   catlistwrappers (default 1) - Number of different sets of alternating elements to be placed before and after each link category section<br/>
   beforecatlist1 (default null) - First element to be placed before a link category section<br/>
   beforecatlist2 (default null) - Second element to be placed before a link category section<br/>
   beforecatlist3 (default null) - Third element to be placed before a link category section<br/>
   divorheader (default false) - Output div before and after cat name if false, output heading tag if true<br/>
   catnameoutput (default linklistcatname) - Name of div class or heading to output<br/>   
   showrssicon (default false) - Output RSS URI if available and assign to standard RSS icon<br />
   linkaddfrequency (default 0) - Frequency at which extra before and after output should be placed around links<br />
   addbeforelink (default null) - Addition output to be placed before link<br />
   addafterlink (default null) - Addition output to be placed after link<br />
   linktarget (default null) - Specifies the link target window<br />
   showcategorydescheaders (default false) - Display link category description when printing category list<br />
   showcategorydesclinks (default false) - Display link category description when printing links<br />
   showadmineditlinks (default false) - Display edit links in output if logged in as administrator<br />
   showonecatonly (default false) - Only show one category at a time<br />
   AJAXcatid (default null) - Category ID for AJAX sub-queries<br />
   defaultsinglecat (default null) - ID of first category to be shown in single category mode<br />
   rsspreview (default false) - Add preview links after RSS feed addresses<br />
   rssfeedpreviewcount(default 3) - Number of RSS feed items to show in preview<br />
   rssfeedinline (default false) - Shows latest feed items inline with link list<br />
   rssfeedinlinecontent (default false) - Shows latest feed items contents inline with link list<br />
   rssfeedinlinecount (default 1) - Number of RSS feed items to show inline<br />
   beforerss (default null) - String to output before RSS block<br />
   afterrss (default null) - String to output after RSS block<br />


== Screenshots ==

1. The Settings Panel used to configure the output of Link Library
2. A sample output page, displaying a list of categories and the links for all categories in a table form.
2. A second sample output showing a list of links with RSS feed icons and RSS preview link.
Return current item: Link Library