Installation Instructions

Nothing will happen unless you a) install a Link-Post Table. You’ll then need to, b), create some Link-Posts to fill it up with!

(A great tool for easy creation of Link-Posts is WordPress’s own Press This: You can make aggregating interesting posts a “few-clicks” operation – for more info check the FAQs.)

TO ADD ONE OR MORE LINK-POSTS TABLES TO A SIDEBAR AREA

Enable the Linkposts widget, like any other WordPress Widget! Most of the main settings can be set on a per-widget basis within the widget settings. You can also just rely on the Main Settings defaults.

TO ADD A LINK-POSTS TABLE TO A PAGE OR POST

Add the following shortcode where you wish the table to appear, for instance in a “sticky” post:

[add_lt]

You can just use the defaults as set in Main Settings, or you can customize the output on a per-table basis. A table of available shortcode arguments appears below. There are also a few arguments available only in shortcodes for setting particular CSS ids or for setting and displaying a “cut-off” date-time.

So, if you wanted to produce a unique table of “Latest Science Links” posts filled only with up to 3 Link-Posts in particular additional category with ID #26, and only those added up to the date of publication of the post or page, with your own custom date-time display, without comment count-links, you could add the following code:

[add_lt table_title="Latest Science Links" number_posts=10 include_cat=Science up_to_post_date=1 datetime_format="Y, l, F j" datetime_before="As of " hide_comments=1 hide_cats=1]

…producing (adjusted for theme/content):

Link-Posts Table via Shortcode with Several Arguments

Link-Posts Table via Shortcode with Several Arguments

Obviously, if you’re going to re-use all or most elements many times, you may want to adjust them in main settings instead.

TO ADD A LINK-POSTS TABLE TO A TEMPLATE FILE IN A STATIC POSITION OR VIA ACTION HOOK

Add the following code where you wish the table to appear, for instance before the Loop:

<?php if (function_exists( 'add_cks_lpa_table' ) ) { echo add_cks_lpa_table( 'before-loop' , '' ) ; } ?>

You can use any PHP/JS allowed characters for the identifier – “before-loop” in the above example. It will produce a unique CSS ID selector for the entire table. In the probably rare case of adding multiple link post tables to the same template output, give a different identifier to each one – like static-1, static-2, etc.

Because themes vary widely, customizing your “in-loop” link-table, whether by this method or as “first post of the day” (see below), will very likely require some fine-tuning – see Custom Styling for more on this topic, and for a simple Add CSS tool you can use.

TO ADD A LINK-POSTS TABLE TO A MAIN PAGE AS “FIRST POST OF THE DAY”

…in other words so that all new posts on any current day appear above it, all previous posts after or below it. I find it a neat way to add it to a moderately active blog:

<?php if (function_exists( 'place_cks_lpa_table_in_loop' ) ) { place_cks_lpa_table_in_loop() ; } ?>

It will go somewhere after while ( have_posts() ): , depending on how your theme is coded, for instance in an index.php or home.php file.