Wikinews:Assistant:View intersection/doc

From Wikinews, the free news source you can write!
Jump to navigation Jump to search


This assistant displays a scrollable list of articles belonging to an intersection of categories. Primary access is through template {{Assistant:View intersection}}, allowing the creation of wikilinks to display category-intersections without requiring the construction of a specialized wiki page for each such intersection desired.

Assistant:View intersection[edit]

Access: viewable.

Inputs:

  • cat-one — a category articles must belong to.
  • cat-two — a second category articles must belong to (except as below).
  • cat-three — a third category articles must belong to (except as below).
  • invert-two — if non-blank, articles must not belong to cat-two.
  • invert-three — if non-blank, articles must not belong to cat-three.
  • unpublished — if require, only list unpublished articles; if allow, list both unpublished and published articles; otherwise (such as if blank), list only published articles.

Function:

Ordinarily —if no more than the first three parameters are used— lists published articles belonging to the intersection of the named categories. The second and third parameters can be inverted, to list only articles that don't belong to those categories instead of articles that do. An additional parameter can change the handling of published versus unpublished articles.

Allows scrolling through the list, similarly to {{topic cat}}; for which purpose, internally uses parameters offset and count.

Assistant:View intersection [Template][edit]

Access: template.

Inputs:

  • cat or cat1 — required — a category articles must belong to.
  • cat2 — optional — a second category articles must belong to (except as below).
  • cat3 — optional — a third category articles must belong to (except as below).
  • not2 — optional — if non-blank, articles must not belong to cat2.
  • not3 — optional — if non-blank, articles must not belong to cat3.
  • unpub — optional — if require, only list unpublished articles; if allow, list both unpublished and published articles; otherwise, list only published article.
  • label — optional — label on the link (default as of this writing is "link").

Function:

Produces a link that, when followed, displays a scrollable list of published articles belonging to the intersection of up to three categories, using dialog tools.

Examples[edit]

code result
{{Assistant:View intersection|cat1=France|cat2=Politics and conflicts}}
{{Assistant:View intersection|cat1=France|cat2=Politics and conflicts|not2=x...}}
{{Assistant:View intersection|cat1=Protected disambiguation pages|unpub=require|label=quux...}}

Internals[edit]

This template embeds its parameters in a url, which invokes dialog action do, which converts the parameters from the url into dialog parameters which it then applies (in the usual template-parameter-like way) to page Wikinews:Assistant:View intersection.