textcastle.com

Version 1 help documentation

ras_author_credits

ras_author_credits returns an href(or not) list of authors with statistics as defined by attribute setting and form values.

Authors are defined as all users who have posted article data, file uploads, or images for the site. TXP's standard list attributes are supported including section and this_section, also a type attribute is available to discriminate amongst user privileges.
The type attribute's options must match exactly the available choices as displayed in TXP's user list options, as follows:

Publisher (1)
Managing Editor (2)
Copy Editor (3)
Staff writer (4)
Freelancer (5)
Designer (6)

Also integer values matching these or custom values can currently be from 0 thru 9. (0 = no privs setting)

The type attribute will accept individual types or integers or a comma delimited list of either or both.

Attributes:

break : Standard TXP attribute. (default is unset)
label : Standard TXP attribute.
labeltag : Standard TXP attribute.
form : Standard TXP attribute.
wraptag : Standard TXP attribute. (default is unset)
type : User privilege filters.
section : Standard TXP attribute.
this_section : Standard TXP attribute.
link : Whether or not to link href, 0 no - 1 yes. (Self closing tag only)
active_only : Show only users that have met select_by criteria, 0 no - 1 yes, default is 1.
select_by : Integer values as set according to a criteria as described in the table below - filters authors by these criterium.
rank_by :

Which content type to use as a ranking criteria (largest number at the top), choices are : "articles, files, images, links, authors" text is not case sensitive but must match exactly one of these five choices. The ranking setting need not match display sets. Three levels of ranking are supported ranked by first to last setting in the comma delimited list.

The sort if only one criteria is set in rank_by is the content type set - then the link text alphabetically. If two or three content types are set, sorting will be by the first to last setting in the comma delimited list.

class : Standard TXP attribute.

ras_author_info

Attributes

author_name : The author's real name. (default is the currently selected author)
title : Set to 1 returns real name, Set to 0 returns user name.
link : Whether or not to link href, 0 no - 1 yes. (Self closing tag only)
wraptag : Standard TXP attribute. (default is unset)
class : Standard TXP attribute.

Form and container usage tags.

Return counts for number of posts of the four content types, or user details as described, on a per user basis by the following tags when used inside a set of container tags or in a form called by ras_author_credits (authors list) or ras_author_info (details by author_name attribute setting on an individual basis rather than part of a list).

<txp:ras_authors /> : List aware "Author tag" for use inside ras_author_credits. (attributes the same as TXP's Author tag)
<txp:ras_articlecount /> : Number of article posts.
<txp:ras_filecount /> : Number of uploaded files.
<txp:ras_imagecount /> : Number of uploaded images.
<txp:ras_linkcount /> : Number of created links.
<txp:ras_author_role /> : The author's priveledge or role setting, takes a wraptag attribute. (default is unset)
<txp:ras_last_login /> : The most recent login date and time (takes the same attributes as TXP's "txp:posted" tag).
<txp:ras_author_mailto /> : An active mailto: link with linktext settings (attributes the same as TXP's "txp:email" tag. ("email" attribute default is the currently active author)
<txp:ras_email_text /> : The author's email address as text.

Settings list for the "select_by" attribute.

1	select if an article has been posted.
2	select if a file has been uploaded.
3	select if an article has been posted or a file uploaded.
4	select if an article has been posted and a file uploaded.
5	select if an article has been posted and a file has not been uploaded.
6	select if a file has been uploaded and an article has not been posted.
7	select if an image has been uploaded.
8	select if an image or a file has been uploaded.
9	select if an image and a file have been uploaded.
10	select if an image has been uploaded and a file has not been uploaded.
11	select if a file has been uploaded and an image has not been uploaded.
12	select if an article has been posted or an image uploaded.
13	select if an article has been posted and an image uploaded.
14	select if an article has been posted and an image has not been uploaded.
15	select if an article has not been posted and an image has been uploaded.
16	select if an article has been posted or an image uploaded or a file uploaded.
17	select if an article has been posted and an image uploaded and a file uploaded.

Plugin releases for TXP 4.4.1

Two plugins released for TXP Ver 4.4.1, ras_author_credits & ras_author_list.

These two plugins are very similar in what they will do on a basic level. With the exception of if_first_author and if_last_author functionality, ras_author_credits will do anything ras_author_list will do – hence two plugins to maintain the option of back compatibility.

On the other hand, ras_author_credits will do a great deal more than ras_author_list and is a significant improvement.

In the final analysis I decided to maintain the option of running these two plugins concurrently and pursuing ras_author_credits and ras_author_list as separate plugins, as to the wisdom of that? only time will tell.

ras_authors_credits

A tag with capabilities quite different from ras_author_list.

A forum user that goes by pompilos , (forum link) requested some improvements to ras_author_list that amounted to a new or variant tag named ras_author_credits.

It is a better plugin in all respects with the exception of if_first_author – if_last_author functionality, which went by the wayside in favor of two deep sorting of the returned list of authors and stats.

The new plugin adds new attributes called active_only, which toggles filtering, select_by which restricts the returned list to a complex criteria set against an authors activity in terms of contribution on a site, and rank_by which sorts, to two levels, numerical ranking of authors contributions by media type.

This plugin will not coexist with ras_author_list nor will it replace it upon installation, so turn off author_list before you fire it up.

It could use some thorough testing to garner a little greater insight into possible improvements – so feel free to participate. Comments can be left on this article or on the forum thread.

Flattr TXP plugin

Just joined Flattr for the sake of checking it out. I’m using joh_flattr in this article’s excerpt. It also seems that I was given a few extra invite keys – if anyone is interested.

Always tweeking TXP.

A new site, a new author, and hopefully in the future some new and interesting ideas. The North Gate Well

Experiments in Textpattern

by category

Me

Others

Currently supported plugins

ras_author_credits "Help Docs"