Textpattern Plugin | rss_suparchive
All details about this plugin can now be found at its new permanent home.
rss_suparchive_bycat plugin page
rss_suparchive_menu plugin page
The rss_suparchive Textpattern plugin contains 3 tags that can be used to generate a variety of article listings. The following are some of the applications of the plugin:
- Article list sorted and grouped by date.
- Article list based on URL pattern.
- Article list sorted and grouped by category/section.
- Archive menu grouped and totaled by month or year.
rss_suparchive
The overall structure used for the rss_suparchive date based archive is the XHTML Definition List (<dl>, <dt> and <dd> tags). Entries will be grouped by date under the <dt> tag. The plugin supports multiple sections and categories and can output links to the section and categories of a particular article.
rss_suparchive_bycat
The newly added rss_suparchive_bycat will generate an article listing in the form of an unordered list and group them by category and optionally by section within each category. The total number of articles in each category and/or section can also be displayed. This listing also solves the problem of listing related articles once the article has been displayed. This allows for a related article listing anywhere on a page as long as a single article is displayed somewhere.
rss_suparchive_menu
The even newer rss_suparchive_menu will generate a listing of months or years along with the total number of posts belonging to each grouping and a link to your archive section. The URLs follow a format of yyyy/mm or yyyy depending on the listing mode you choose and the rss_suparchive now supports filtering based on these URL patterns.
Example
- 07 :: Textpattern Solutions Authors Interview
- 03 :: Who are you and what are you doing here?
miscellany - 28 :: A new dawn
- 28 :: Textpattern Solutions
- 15 :: rss_auto_excerpt 0.5
textpattern
Comments
5. November 2004
great plugin, and good doumentation too. much easier than other txp archive plugins, thanks.
8. November 2004
Okay, section default is “article” and I renamed this into “weblig”. Alright!
8. November 2004
It seems that your Plugin will only work in “clean-” and not in messy-mode. That’s a great pity, because on my server i can only work messy…
8. November 2004
Thanks all for the great feedback!
Sorry Holger. I’ll take a look at adding support for messy URLs. Stay tuned at the forums for an update…
8. November 2004
Holger – The newest version (0.5) contains support for messy URLs on the article, section and category. I don’t use messy URLs so let me know if it works.
Here’s the rss_suparchive forum thread
9. November 2004
@Rob
Thanx a lot. It works fine. Great work.
U can see it here: http://www.holligay.de/blog/?s=archiv
16. November 2004
Rob, you are indeed a fine fella.
I’ve been struggling with various formats and plugins over the last couple of days to try and come up with a simple solution to archives in TXP. This is what I’ve been looking for all along. It’s an excellent plugin and I thank you for it.
16. December 2004
Hi, tried downloading your plugin, but i get a corrupted file, something like:
$plugin=’YTo4OntzOjQ6Im
5hbWUiO3M6MTQ6InJzc19zdXBhcmNoa’
etc…
This has also ocurred with other plugins, from other sites also.
Any idea why this is happening?
Alex
20. December 2004
The plugin is not corrupted. Its is base64 encoded as all plugins are. You can find tips on installing a textpattern plugin on the forums. Basically, you just need to upload the txt file through the admin plugin screen and it will be decoded for you.
20. December 2004
In fact, there seemed to be an error in my 1.0rc1 version, not correctly importing plugins via text files. Corrected this through the development site. Using the plugin now. Thank u.
Alex
31. December 2004
Hey, thanks for this! I was previous manually outputting all archive lists using different tags for each category, this’ll make it so much easier!
5. January 2005
I am getting PHP errors at the top of the page:
Error 8 Undefined variable: catsql in rss_suparchive(), /u/htdocs/graphi10/textpattern/publish.php(767) : eval()’d code line 943
Error 8 Undefined variable: authsql in rss_suparchive(), /u/htdocs/graphi10/textpattern/publish.php(767) : eval()’d code line 948
Error 8 Undefined variable: categories in rss_suparchive(), /u/htdocs/graphi10/textpattern/publish.php(767) : eval()’d code line 950
Error 8 Undefined variable: authors in rss_suparchive(), /u/htdocs/graphi10/textpattern/publish.php(767) : eval()’d code line 950
Any clues?
7. January 2005
The errors are due to the use of the zem_debug plugin. Just some bad coding that fails silently unless you have PHP error logging on as in the zem_debug plugin.
This will be cleaned up in a future release.
7. January 2005
Beautiful work and great plugins. Just one problem – I can’t seem to make “category” work for rss_suparchive. Instead, it just displays all of the entries, regardless of category. My category is called “Favorites” and the tag is < txp:rss_suparchive category="Favorites" section="journal" />, but no go. It really seems like it should work… I’d appreciate your input!
27. January 2005
Amazing work and for once, in the world of Txp plugin, very well documented.
28. January 2005
This plugin is superb. Thank you so much for such a straightforward and well-documented addition to TXP.
Nathaniel
7. February 2005
w1, greets…
just installed the latest version 0.8 and lost some of my sub-dates…
code is: < txp:rss_suparchive section="entry" dateformat="Y" showsubdate="1" subdateformat="D d M" subdatesep=" – " class="archive" / >
previously I got Mon 3 Dec – Article Title but now I just get 3 – Article Title
(g1.19 with clean urls on Txd)
second question: is it possible to group by year and month? so “2005” groups months, “February” groups Feb articles … ?
nardo
8. February 2005
That is a minor bug that was introduced in the latest version. See the Textpattern forum for the fix.
And no, the grouping by year and month is not possible.
9. February 2005
thanks Rob, good work
nardo
16. February 2005
Hi There, thanks a lot for the great plugin.
I found a small error in the documentation above:
catstart
Places the given text before the category links.
Default: ‘under’
Example: dateformat=”Under:”
It says dateformat instead of catstart. I know, you have to be stupid to not understand, but I thought I might let you know.
thanks again,
Bert
21. February 2005
Dude, this is a wicked-ass plugin, but I have a question:
How do I format this thing to output an archive listing by date when someone clicks the archive link, but outputs a single article form when a permalink is clicked?
mike
21. February 2005
This is delicious. How did I not notice it before?
Thank you so much for the plugin and the quick RC3 update!
21. February 2005
I just noticed an error in this documentation – there’s the option for “limit” and then “exclude” immediately follows, except you called it “limit” again.
21. February 2005
Thanks, just noticed that too. That should have read offset as it does now.
24. February 2005
Mike – Just place the rss_suparchive on its own page in its own section. The permlinks that are generated will link back to the appropriate section to display your article.
1. March 2005
hey I was thinking about using this plugin but I was hoping that there would be some way to display the excerpt of the post. Without going into too much detail, I do short posts often and hate that the date is shown for everyone. Could I use your plugin to make my homepage dispay posts this way:
09/15————-
First post
Excerpt goes here
second post
Excerpt goes here
———————
09/14————-
First post
excerpt goes here
Second post
excerpt goes here
———————
Any help would be appreciated!
Amit
8. March 2005
Rob, small typo in documentation… ‘mode’ attributes in rss_suparchive_menu currently shows ‘timeframe’ etc
but my question is about RC3 and the view by date options… e.g. /archive/2005/02/
this is not working on my dev site with the latest svn update—but I see it’s not working on this site either, so I figure it’s a known issue
and is there a recommended url scheme for use with rss_suparchive?
thanks again for this plugin, it’s tip top
nardo
9. March 2005
Well doesn’t that suck. It worked on a previous rev. Still works on my local version. I’ll have to see what changed.
9. March 2005
The Update: It appears I broke something in version 0.11. Its fixed now in the download.
11. March 2005
yep, good one
‘nother question: any way to use rss_suparchive_menu on an individual article to show “also in this month” ?
long shot… for programme of events
nardo
13. March 2005
having a small problem with rss_suparchive_menu—even though I’ve defined the section in the tag, it’s generating a link to the currently browsed section
my tag: < txp:rss_suparchive_menu mode="MONTH" section="programme" timeframe="FUTURE" limit="5" showcount="0" / >
so when I’m in the ‘programme’ section, the links to the months are fine… but when in say the ‘contact’ section, links look like ”/contact/2005/03”
nardo
14. March 2005
The attribute you want to use is linktosection which allows you to set which section you will link to.
And there’s no way now to generate an “also in this month” type listing.
14. March 2005
do’h—couldn’t see the wood for the trees—thank you
nardo
29. March 2005
Thanks for adding the form attribute to rss_suparchive_bycat in version 0.14. You just made my world! See my comments at the forum.
31. March 2005
Is it possible to get suparchive to output a comment count on listed articles?
13. June 2005
Oh THANK YOU!
I just found this plugin through a post I made in the forums tonight. I had seen a site utilizing it and just HAD to find out what they were using. I received a prompt reply telling me about your plugin.
I’m a bit confused though. I don’t quite understand the implementation on creating the page. Do I have to create a new section or page … like http://newbiehangout.com/blog/archive ? Or do I just add the “super archive code” to my archive template in txp?
Thanks soo much!
13. June 2005
I’m really lost now ;o)
I can’t figure out how to make the superarchive work with messy url’s.
The only way I was able to get something similar to what I want to do was to create a section and then a post using that section which looks like this
But normally I have the output of my posts in a more user-friendly url and then they only end up within the scgi-bin when they browse.
I’d like to create a similar page like http://newbiehangout.com/blog/archive but am lost.
Can anyone give me some idea of how to implement this as it’s own page using messy url’s?
Thanks in advance!
15. July 2005
I emplemented this on 1.0rc3, created a form with -txp:suparchive /- in it, and linked to that form using a page which the archive section uses. It works, but I get two errors above it:
Notice: Undefined variable: count in C:Program FilesApache GroupApache2htdocstextpatternlibtxplib_misc.php(351) : eval()’d code on line 215
Notice: Undefined index: realname in C:Program FilesApache GroupApache2htdocstextpatternlibtxplib_misc.php(351) : eval()’d code on line 202
Any ideas?
Mitch
12. August 2005
Hey, great plugin! You’re an archive saver! :)
I noticed a problem with my archive list, though. I’ve got an article being linked to twice from two links that should be different.
IE. http://www.sanlive.com/archive (“coincidentally speaking” and “self ish” both link to “coincidentally speaking”)
I can’t find what the problem may be. I’ve tried changing entry titles but still have a problem. I’m using the section/title url format in 1.0rc3. :( Heard of anyone else with that problem or a solution for it?
28. October 2005
hello, your plugin is very useful, I was just wondering… since Txp is now at version 4 isn’t it possible to display a list of articles arranged by section/category with the use of default Txp tags?
nico
26. November 2005
How can I get rss_superarchive to group the archive by Month, instead of by day? I am really confused, I want it sorted similar to this http://www.wilshireone.com/archive
13. February 2006
Hello,
Im trying to get this plugin working for my site.
In the page section i use this
< txp:rss_suparchive section="article,zwangerschap,bevalling" dateformat="F Y" showsubdate="1" />
I know that the must be no space between the < and the tpx tag but i know no other way to let you see this.
Now on the first page the plugin makes output.
But when i click on one of the permlinks the page appears but without the output of this plugin.
How can i make things working.
I asked on the forum but nobody knows the answer.
Roelof
1. April 2006
Rob, About the comment to get the “individual article” code working, I found a small little part that can be changed in the plugin that allows me (for the moment) to accomplish this. Perhaps we can find a solid way to do it in the future.
In your plugin…
around line 160… I just changed rss_suparchive, nothing else
changing to
if ($showY && is_numeric($u2) && is_numeric($u4) && !$thisarticle) $posted = ” AND Posted LIKE ’”.$showY.$showM.$showD.”%’ ”;
seems to work. It stops the article title from being interpreted as part of the date.
Harold
26. April 2006
Everything is cool, rss produces nice listings like:
.../archive/2006/03
.../archive/2006/02
But how to tell textpattern to show the articles itself from March 2006, nothing more and nothing less?
txp:if_individual_article
Individual here (yes, it works! :)
txp:article /
txp:else /
I HAVE NO CLUE HOW TO SEPERATE THE MONTHS AND YEARS
txp:article /
/txp:if_individual_article
Any hints?
Thanks in advance
omg
7. July 2006
Any chance that rss_suparchive will be accommodating rss_unlimited_categories at some point? :)
All working beautifully besides..
thanks as always.
Commenting is closed for this article.
