div.crossreferences a { color:green; }<h3>Template Funtions<\/h3>\n<\/code><\/pre>\n\nFuntion `the_crossreferences`<\/h4>\n\n
You can place this function at your templates, in order to get the related posts list for a particular post or page. You do not need to use this, because the plugin shows the list automatically, but this function gives you a greater control on the appearance and the position of the list. If you use this function, please set up \"Do not show related posts list\" at the admin panel \/ Settings \/ Cross-references. Otherwise the related posts list will appear twice.<\/p>\n\n
the_crossreferences($before,$between,$after,$id,$emptylist)\n\n $before - Optional. This string being printed once before the related posts list (only if there is 1 related post or more)\n $between - Optional. This string being printed between 2 entries in the related posts list.\n $after - Optional. This string being printed once after the related posts list (only if there is 1 related post or more)\n $emptylist - Optional. This string being printed if there are no related posts.\n $id - Optional. The post id number to which the related posts list are shown. Defaults to the current post or page.\n<\/code><\/pre>\n\nExamples:<\/p>\n\n
If you write <?php the_crossreferences() ?><\/code> you get an output such as (here without hyperlinks):<\/p>\n\n\n<ul><li>Post title 1<\/li><li>Post title 2<\/li><li>Post title 3<\/li><\/ul><\/code> (if there are 3 related posts)<\/li>\n- Nothing (if there are no related posts)<\/li>\n<\/ul>\n\n
If you write <?php the_crossreferences('See also:', '; ', '.') ?><\/code> you get an output such as:<\/p>\n\n\nSee also: Post title 1; Post title 2; Post title 3.<\/code> (if there are 3 related posts)<\/li>\n- Nothing (if there are no related posts)<\/li>\n<\/ul>\n\n
If you write <?php the_crossreferences('See also:', '; ', '.',0,'There are currently no related posts.') ?><\/code> you get an output such as:<\/p>\n\n\nSee also: Post title 1; Post title 2; Post title 3.<\/code> (if there are 3 related posts)<\/li>\nThere are currently no related posts.<\/code> (if there are no related posts)<\/li>\n<\/ul>\n\nIf you write <?php the_crossreferences('<h2>Related posts<\/h2><ul><li>') ?><\/code> you get an output such as:<\/p>\n\n\n<h2>Related posts<\/h2><ul><li>Post title 1<\/li><li>Post title 2<\/li><\/ul><\/code> (if there are 2 related posts)<\/li>\n- Nothing (if there are no related posts)<\/li>\n<\/ul>\n\n
If you write <h2>Related posts<\/h2><?php the_crossreferences() ?><\/code> you get an output such as:<\/p>\n\n\n<h2>Related posts<\/h2><ul><li>Post title 1<\/li><li>Post title 2<\/li><\/ul><\/code> (if there are 2 related posts)<\/li>\n<h2>Related posts<\/h2><\/code> (if there are no related posts)<\/li>\n<\/ul>\n\nIt is better to enclose the call to the_crossreferences()<\/code> within a if function_exists()<\/code> block, otherwise your template will raise an error if the plugin is inactive.<\/p>\n\nif (function_exists('the_crossreferences')) the_crossreferences();\n<\/code><\/pre>\n\nFunction `get_the_crossreferences`<\/h4>\n\n
Same as above, but you get a string instead of an output to screen:<\/p>\n\n
$string = get_the_crossreferences($before,$between,$after,$id,$emptylist);<h3>Template Funtion Filters<\/h3>There are the following filters available for the functions `the_crossreferences()` and `get_the_crossreferences()`:\n<\/code><\/pre>\n\n`cref_order_by`<\/h4>\n\n
With this filter you can define the sort order of the related posts list. Examples:<\/p>\n\n
Place this at the functions.php file of your template in order to sort the related posts from older to newer:<\/p>\n\n
add_filter('cref_order_by','mytheme_order_by');\nfunction mytheme_order_by() { return 'post_date'; }\n<\/code><\/pre>\n\nPlace this in order to sort the related posts by post title:<\/p>\n\n
add_filter('cref_order_by','mytheme_order_by');\nfunction mytheme_order_by() { return 'post_title'; }\n<\/code><\/pre>\n\nPlace this in order to sort the related posts by post title descending Z-A:<\/p>\n\n
add_filter('cref_order_by','mytheme_order_by');\nfunction mytheme_order_by() { return 'post_title DESC'; }\n<\/code><\/pre>\n\n`cref_post_from`<\/h4>\n\n
With this filter you can define how the link to a related post is shown.<\/p>\n\n
Parameters: $default, $post<\/p>\n\n
\n- $default - The default appearence (hyperlinked post title)<\/li>\n
$post - Related post info. You can use this properties:<\/p>\n\n
$post->ID - The ID number\n $post->post_title - Post Title\n $post->post_excerpt - Post Excerpt\n $post->post_content - Post Content\n etc. (all fields from the table wp_posts)\n<\/code><\/pre><\/li>\n<\/ul>\n\nExamples:<\/p>\n\n
Place this at your template to get each related post as: <hyperlinked post title> (<author>, <date>)<\/code><\/p>\n\nadd_filter('cref_post_from','mytheme_post_from',10,2);\nfunction mytheme_post_from($default,$post) {\n $author = get_author_name($post->post_author);\n $date = mysql2date(get_option('date_format'),$post->post_date);\n return \"$default ($author, $date)\";\n}\n<\/code><\/pre>\n\nPlace this to get the same as above but being the whole (not just the title) hyperlinked to the related post:<\/p>\n\n
add_filter('cref_post_from','mytheme_post_from',10,2);\nfunction mytheme_post_from($default,$post) {\n $url = get_permalink($post->ID);\n $title = $post->post_title;\n $author = get_author_name($post->post_author);\n $date = mysql2date(get_option('date_format'),$post->post_date);\n return '<a href=\"'.$url.'\">'.$title.' ('.$author.', '.$date.')<\/a>';\n}\n<\/code><\/pre>\n\n`cref_before`<\/h4>\n\n`cref_between`<\/h4>\n\n`cref_after`<\/h4>\n\n`cref_emptylist`<\/h4>\n\n
With this filters you can control the parameters of the template function (s. above).<\/p>\n\n\n
First installation<\/h4>\n\n\n- \u4e0a\u4f20\u8be5\u63d2\u4ef6\u5230\u4f60\u7684\/wp-content\/plugins\/\u76ee\u5f55\u4e0b<\/li>\n
- \u6fc0\u6d3b\u8be5\u63d2\u4ef6\uff1b<\/li>\n
- \u5230Ex-Cross-Reference\u9875\u9762\u6839\u636e\u81ea\u5df1\u7684\u9700\u6c42\u505a\u4e00\u4e9b\u8bbe\u7f6e\uff0c\u5305\u62ec\u662f\u5426\u5305\u542b\u663e\u793a\u76f8\u5173\u6587\u7ae0\u7b49\uff1b<\/li>\n
- \u5230\u201c\u6dfb\u52a0\u65b0\u6587\u7ae0\u201d\u9875\u9762\uff0c\u9009\u62e9\u7f16\u8f91\u6846\u4e0a\u9762\u7684\u201c\u63d2\u5165\u5386\u53f2\u6587\u7ae0\u201d\u6309\u94ae\uff0c\u4f1a\u5f39\u51fa\u4e00\u4e2a\u6d4f\u89c8\u5386\u53f2\u6587\u7ae0\u7684\u5bf9\u8bdd\u6846\uff0c\u9009\u62e9\u4efb\u4f55\u4e00\u7bc7\u4f60\u60f3\u63d2\u5165\u7684\u6587\u7ae0\u5230\u4f60\u7684\u7f16\u8f91\u5668\u91cc\u3002Enjoy...<\/li>\n<\/ol>\n\n\n
\u4ee5\u4e0bFAQ\u6765\u81ea\u4e8e\u539f\u59cb\u63d2\u4ef6\uff0cEx Cross Reference\u5bf9Cross Reference\u505a\u4e86\u4e8c\u6b21\u5f00\u53d1\uff0c\u6240\u4ee5\u5305\u542b\u539f\u63d2\u4ef6\u6240\u6709\u7684\u529f\u80fd\u3002<\/p>\n
\n- Are references automatically updated whenever the refered\/referer post title changes?<\/dt>\n
Yes, since the title of the post is read dynamically when it is shown.<\/p><\/dd>\n
- What happens if I delete a post to which there are references?<\/dt>\n
All links will be removed from the referer posts, but their text (possibly the title of the removed post) will remain unchanged.<\/p><\/dd>\n
- What happens if I set a reference to a draft\/pending\/private post?<\/dt>\n
No links will be shown on the referer posts (just possibly the title of the hidden post) until it is made public. The hidden post will also not appear at the back links list from other posts. The same happens if you set a reference to a published post and then you hide it.<\/p><\/dd>\n
- What happens if I change a slug which is being referred to?<\/dt>\n
Because of the way WordPress handles slugs, if you reference posts by slug all references to it would be broken. You need to rename slugs with the tool \"slug rename\" at the plugin settings page (Admin panel \/ Settings \/ Cross-References).<\/p><\/dd>\n
- After upgrading this plugin from v1.2 to 1.3 I get a fatal error<\/dt>\n
If you get an error such as: Fatal error: Cannot redeclare cref_setup() (previously declared in [...]\/wp-content\/plugins\/cross-references-plugin\/crossreferences.php:227)\nin [...]\/wp-content\/plugins\/crossreferences.php on line 95<\/code> you need to remove the file \/wp-content\/plugins\/crossreferences.php, which is the old plugin v1.2.<\/p><\/dd>\n- Is this plugin compatible with the multilanguage plugin qTranslate?<\/dt>\n
Yes. At the plugin settings page just write for example:<\/p>\n\n
<h1>[lang_es]Entradas Relacionadas: [\/lang_es][lang_en]Related Posts: [\/lang_en]<\/h1>\n<\/code><\/pre><\/dd>\n- Known issues with other plugins<\/dt>\n
\"HeadSpace2\" Plugin - In cross-references v. 1.3 until 1.4.01 there was a bug. This bug could have caused problems with other plugins that change post titles, too. Please update to cross-references v. 1.4.02 or above or downgrade to v. 1.2 to avoid this problems.<\/p>\n\n
\"Raw HTML\" Plugin - [cref ...] tags will not work when placed into a block <!--start_raw--> ... [cref ...] ...<!--end_raw--><\/code>. This is because of the way the Raw HTML plugin works. It overwrites the content in raw-blocks after all content filters apply with the original contents. Workaround: <!--start_raw--> ... <!--end_raw-->[cref ..]<!--start_raw--> ... <!--end_raw--><\/code>.<\/p><\/dd>\n\n<\/dl>\n\n\nVersion 1.8 9\/15\/2009<\/h4>\n\n