WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Link Library

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.

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
  2. Upload link-library.php to the /wp-content/plugins/ directory
  3. Activate the plugin in the WordPress Admin
  4. Use the following functions in a new template and select this template for your page that should display your Link Library.
<?php echo $my_link_library_plugin->LinkLibraryCategories('name', 1, 100, 3, 1, 0, '', '', '', false, '', ''); ?><br />

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

=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 <br />) - 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
linkaddfrequency (default 0) - Frequency at which extra before and after output should be placed around links
addbeforelink (default null) - Addition output to be placed before link
addafterlink (default null) - Addition output to be placed after link
linktarget (default null) - Specifies the link target window
showcategorydescheaders (default false) - Display link category description when printing category list
showcategorydesclinks (default false) - Display link category description when printing links
showadmineditlinks (default false) - Display edit links in output if logged in as administrator
showonecatonly (default false) - Only show one category at a time
AJAXcatid (default null) - Category ID for AJAX sub-queries
defaultsinglecat (default null) - ID of first category to be shown in single category mode
rsspreview (default false) - Add preview links after RSS feed addresses
rssfeedpreviewcount(default 3) - Number of RSS feed items to show in preview
rssfeedinline (default false) - Shows latest feed items inline with link list
rssfeedinlinecontent (default false) - Shows latest feed items contents inline with link list
rssfeedinlinecount (default 1) - Number of RSS feed items to show inline
beforerss (default null) - String to output before RSS block
afterrss (default null) - String to output after RSS block

Requires: 2.7 or higher
Compatible up to: 3.9
Last Updated: 2014-4-19
Downloads: 368,043

Ratings

4 stars
4.4 out of 5 stars

Support

5 of 20 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,2,2 100,1,1
100,3,3 100,1,1
100,2,2
100,1,1 50,2,1 0,1,0 100,1,1 100,1,1 100,2,2 100,1,1
100,6,6 100,3,3 100,1,1 0,1,0 0,1,0 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 0,1,0 0,1,0 100,1,1
100,3,3 100,2,2 100,1,1 100,1,1 0,2,0 100,1,1
100,1,1 100,1,1 0,12,0 100,1,1 100,2,2 100,4,4 100,1,1 100,1,1 0,1,0 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1 50,2,1 100,4,4 100,1,1 0,1,0 100,3,3
100,1,1
100,1,1 100,1,1
100,2,2 100,3,3 0,2,0 67,3,2 67,6,4 100,1,1 100,2,2 100,1,1
100,2,2
100,1,1
0,1,0
100,1,1 0,2,0 100,2,2 100,3,3 100,1,1 100,2,2 100,1,1 100,2,2 100,1,1 83,6,5
100,2,2 0,1,0
100,1,1 50,2,1 50,2,1 13,8,1 50,4,2
100,1,1 100,3,3
100,4,4 100,2,2
100,1,1 100,1,1 50,2,1 0,1,0 100,2,2 100,1,1 0,1,0
100,2,2 0,1,0
100,1,1 100,4,4 100,1,1 100,2,2 0,1,0 50,2,1 100,1,1 100,3,3 100,1,1
0,1,0 100,1,1
75,4,3
100,1,1
100,1,1 100,1,1 67,3,2
100,1,1
100,1,1
0,5,0 100,3,3