ras_author_credits "Help Docs"

2.07.11

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.
— Rick Silletti

,

Section: article


Comment

  1. This is Version 1 help documentation.

    — Rick · Jul 3, 09:37 pm · #

  2. Hi. The ras_author_list is exactly what I needed. I will send off a donation today!

    One question on this though, I used the simple tag of: <txp:ras_author_list break=“li” wraptag=“ul” type=“Publisher,Managing Editor,Copy Editor,Staff writer,Freelancer,7” label=“Editors” labeltag=“h3” /> And it produces a list of the websites Authors. However, when I click one of the links it sends me out of the page I was on (Articles) and back to the Home page. I’m not a tag expert, so I’m wondering how I can point the results to a specific page.

    One other question, do you have a similar plugin to list all categories?

    Best,
    Richard

    — Richard Hamel · Aug 24, 10:17 am · #

  3. Hi,
    ras_author_list has a “section” attribute that you can set to a specific section name. When you set “on front page” to no for that section you can assign a specific page of your choice as the landing page for that section. You can also use the “this_section” attribute as a way of restricting to the current section. This will also restrict articles to those assigned to both section and author, however.

    There is a core tag called category_list:“http://textcastle.com/reference_4_3/category_list.html” that author_list was patterned after that does the same for categories, the link provided will take you to a brief description; the best is on textbook @ category_list:“http://textpattern.net/wiki/index.php?title=category_list” which is more comprehensive write-up.

    — Rick · Aug 24, 06:34 pm · #

Name
E-mail
http://
Message
  Textile Help