DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:wp_most_recent

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
plugin:wp_most_recent [2009-10-04 13:13] lupo49plugin:wp_most_recent [2018-06-03 13:40] Aleksandr
Line 1: Line 1:
-====== Dokuwiki Plugin - WordPress Most Recent Entries ======+====== WordPress Most Recent Entries Plugin ======
  
 ---- plugin ---- ---- plugin ----
-description: Show recent (or all) entries from any WordPress blog using a template.+description: Show recent (or all) entries from any WordPress blog using a template
 author     : Peter DeWeese author     : Peter DeWeese
 email      : peterdeweese@earthlink.net email      : peterdeweese@earthlink.net
 type       : syntax type       : syntax
-lastupdate : 08-26-2005+lastupdate : 2005-26-08
 compatible :  compatible : 
 depends    :  depends    : 
 conflicts  conflicts 
 similar    :  similar    : 
-tags       : WordPress+tags       : embed, changelog 
 + 
 +downloadurl:  
 +bugtracker :  
 +sourcerepo :  
 +donationurl:  
 + 
 +screenshot_img: 
 ---- ----
  
Line 18: Line 25:
 ===== Description ===== ===== Description =====
  
-Wordpress Most Recent Entries allows you to show the most recent entries from wordpress blogs in any Dokuwiki page. The display and many properties are completely customizable, and polish can be added. For example, dates can be displayed as “1 day 7 hours ago”, and summeries are ended with “[...]”. This is my first PHP project, so please give me tips! For bugs and tips (not gripes), email mailto:peterdeweese@earthlink.net. Please include the exact versions of dokuwiki and wordpress that you are using with a full description of any issue. FIXME (add a compatibility chart) +FIXME: Broken Download Link 
 + 
 +Wordpress Most Recent Entries allows you to show the most recent entries from wordpress blogs in any Dokuwiki page. The display and many properties are completely customizable, and polish can be added. For example, dates can be displayed as “1 day 7 hours ago”, and summeries are ended with “[...]”. This is my first PHP project, so please give me tips! For bugs and tips (not gripes), email mailto:peterdeweese@earthlink.net. Please include the exact versions of dokuwiki and wordpress that you are using with a full description of any issue. FIXME (add a compatibility chart)
  
 ===== Download ===== ===== Download =====
  
-^ Version     status  link                                    +^ Version     Status   Link  
-| 08-26-2005 |  alpha  | [[http://peter.deweeses.net/lib/exe/fetch.php?cache=cache&media=programming%3Awp_most_recent-20050826.tgz|programming:wp_most_recent-20050826.tgz]] FIXME | +| 08-26-2005 |  alpha   | [[http://peter.deweeses.net/lib/exe/fetch.php?cache=cache&media=programming%3Awp_most_recent-20050826.tgz|programming:wp_most_recent-20050826.tgz]] FIXME | 
-| 08-18-2005 | alpha  | [[http://peter.deweeses.net/lib/exe/fetch.php?cache=cache&media=programming%3Awp_most_recent-20050818.tgz|programming:wp_most_recent-20050818.tgz]] FIXME | +| 08-18-2005 |  alpha   | [[http://peter.deweeses.net/lib/exe/fetch.php?cache=cache&media=programming%3Awp_most_recent-20050818.tgz|programming:wp_most_recent-20050818.tgz]] FIXME | 
-| 08-17-2005 | alpha  | [[http://peter.deweeses.net/lib/exe/fetch.php?cache=cache&media=programming%3Awp_most_recent-20050817.tgz|programming:wp_most_recent-20050817.tgz]] FIXME | +| 08-17-2005 |  alpha   | [[http://peter.deweeses.net/lib/exe/fetch.php?cache=cache&media=programming%3Awp_most_recent-20050817.tgz|programming:wp_most_recent-20050817.tgz]] FIXME | 
-| 08-16-2005 | alpha  | wp_most_recent-20050816.tgz        |+| 08-16-2005 |  alpha   | wp_most_recent-20050816.tgz        |
  
 ===== Features ===== ===== Features =====
Line 38: Line 47:
 ===== Installation ===== ===== Installation =====
  
-  - Under your wiki installation, create the directory lib/plugins/wp_most_recent+  - Under your wiki installation, create the directory ''lib/plugins/wp_most_recent''
-  - Place syntax.php’ into this directory.+  - Place ''syntax.php'' into this directory.
   - Configure using the instructions below.   - Configure using the instructions below.
  
 ===== Configuration ===== ===== Configuration =====
  
-Configure wp_most_recent in your dokwiki installation under conf/local.php. +Configure wp_most_recent in your DokuWiki installation under ''conf/local.php''.
  
 ==== Caching ==== ==== Caching ====
  
-Since WordPress blogs are databased as dynamic, the semi-static nature of Dokuwiki rendering can get in the way.+Since WordPress blogs are databased as dynamic, the semi-static nature of DokuWiki rendering can get in the way.
  
   * Set the maximum cache length to a reasonable value. For many sites, a half hour to a one day period will be reasonable.   * Set the maximum cache length to a reasonable value. For many sites, a half hour to a one day period will be reasonable.
Line 56: Line 65:
 === WordPress Database Aliases === === WordPress Database Aliases ===
  
-At least one alias is required, but you can also configure the plugin to work with multiple WordPress databases. By default, the default alias should be named “default”. For each alias of name <aliasname>, include the following properties: +At least one alias is required, but you can also configure the plugin to work with multiple WordPress databases. By default, the default alias should be named “default”. For each alias of name <aliasname>, include the following properties:
  
 <code php> <code php>
Line 70: Line 79:
 === Override Default Attributes === === Override Default Attributes ===
  
-Although any attribute can be defined by editing the wiki tags, a default attribute can be overridden using the following line: +Although any attribute can be defined by editing the wiki tags, a default attribute can be overridden using the following line:
  
 <code php> <code php>
-$conf['wp_most_recent']['defaults']['<attribute>']='<value>';+$conf['wp_most_recent']['defaults']['<attribute>' ] = '<value>';
 </code> </code>
  
Line 94: Line 103:
 === Attributes === === Attributes ===
  
-^ Attribute ^  Default ^ Description ^ +^ Attribute          ^ Default       ^ Description   
-| blog  default| A configured WordPress database alias.|  +''blog''            ''default''  | A configured WordPress database alias  
-| category  | none  | A category constraint or no value to display all categories.|  +''category''        none         | A category constraint or no value to display all categories  
-| cat_delimeter | , '  | A string to join categories if more than one exists.|  +''cat_delimeter''   '', '      | A string to join categories if more than one exists  
-| cat_max  | -1  | The maximum number of categories to display for an entry or -1 for no limit.|  +''cat_max''         ''-1''       | The maximum number of categories to display for an entry or ''-1'' for no limit  
-| cat_template  @name@| A template for each category found. This is then used to replace @categories@. Must be HTML encoded! (=&quot;, etc.)|  +''cat_template''    ''@name@''   | A template for each category found. This is then used to replace ''@categories@''. Must be HTML encoded! (''=&quot;'', etc.)  
-| content_max  | 128  | The number of chars to truncate a content summary at or -1 for no limit. If needed, the content will be truncated at a word boundary and appended with ...’.|  +''content_max''     ''128''      | The number of chars to truncate a content summary at or ''-1'' for no limit. If needed, the content will be truncated at a word boundary and appended with ''%%...%%''  
-| link  | true  | Add a link to the title? true” or false|  +''link''            ''true''     | Add a link to the title? ''true'' or ''false''  
-| max  | 10  | The maximum number of entries to display or -1 for no limit.+''max''             ''10''       | The maximum number of entries to display or ''-1'' for no limit  | 
 + 
 +=== Template Tokens ===
  
-Template Tokens 
  
 Tokens are surrounded with ‘@’. Ex: @title@ Tokens are surrounded with ‘@’. Ex: @title@
-Entry Template 
-Token Description 
-@author@ Entry author’s nickname 
-@categories@ Generated using the category template and delimeter 
-@content@ Entry content, formatted with the content_max attribute 
-@date@ Entry date 
-@excerpt@ Entry exceprt 
-@time_ago@ @date@ formatted as “1 hour, 7 minutes ago” 
-@title@ Entry title. May contain link using @url@. 
-@url@ Link to entry. 
- 
-Category Template 
-Token Description 
-@name@ Category name 
-@nicename@ Category’s short name  
- 
- 
- 
- 
- 
- 
  
 +^ Entry Template   ^^
 +^ Token             ^ Description   ^
 +| ''@author@''      | Entry author’s nickname  |
 +| ''@categories@''  | Generated using the category template and delimeter  |
 +| ''@content@''     | Entry content, formatted with the ''content_max'' attribute  |
 +| ''@date@''        | Entry date  |
 +| ''@excerpt@''     | Entry exceprt  |
 +| ''@time_ago@''    | ''@date@'' formatted as “1 hour, 7 minutes ago”  |
 +| ''@title@''       | Entry title. May contain link using ''@url@''  |
 +| ''@url@''         | Link to entry  |
  
 +=== Category Template ===
  
 +^ Token           ^ Description  ^
 +| ''@name@''      | Category name |
 +| ''@nicename@''  | Category’s short name |
  
 +==== Upcoming Features ====
  
 +  * category template aliases
 +  * :-( dokuwiki syntax
 +  * add user full name, first name, and last name as tokens
  
 ===== Discussion ===== ===== Discussion =====
plugin/wp_most_recent.txt · Last modified: 2024-02-08 08:56 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki