Template:Transclude selected current events/doc

This templates transcludes current events on specified topics from the daily subpages of Portal:Current events. It is intended for use in the "In the news" sections of Portals.

Usage

{{Transclude selected current events | <search pattern 1> | ... | <search pattern n> | not1= | ... | notn= | days= | max= | none= | dates= | more= |header= |footer= }}

Basic

{{Transclude selected current events| search pattern }}

Multiple search patterns

{{Transclude selected current events| search pattern | second search pattern | third search pattern }}

Add as many search patterns as needed

With patterns to exclude items

{{Transclude selected current events| search pattern | not=search pattern to exclude from results }}

Add additional search patterns to exclude items from results using |not2=, |not3=, etc.

As a portal component which only displays when news items are found

{{Transclude selected current events| header= header template | footer= footer template | other parameters }}

As a suggestion generator, e.g. on the portal talk page

{{Transclude selected current events| wikitext=yes | other parameters }}

Parameters

|1=, |2=, |3= ...

Search patterns for items

|not1=, |not2=, |not3= ...

Search patterns for excluding items

|days=

Number of days to search through for current events (counting backwards from the current day); default is 30 (nb. you may find large numbers equal to several years won't work for technical reasons).

|max=

Maximum number of items to display; default is 6

|wikitext=

Set to yes to display the wikitext of the items, e.g. when using this template just to generate suggestions

|none=

Wikitext to display if no matching items are found; default is "No recent news"

|dates=

Set to mdy to use MDY-formatted dates (e.g. Nov 22, 2024 rather than 22 Nov 2024)

|more=

Wikitext to show at the bottom of the list; OR

Set to yes to show More current events... link at the bottom of the list

|header=

Wikitext to show above the items; typically {{Box-header}} or {{Box-header colour}} or similar (with appropriate parameters filled in)

If set, this template only displays output when items are found (overriding |more= if set)

|footer=

Wikitext to show below the items; defaults to {{Box-footer}}

Can only be used in conjunction with |header=

Search patterns

Search patterns are Lua patterns, which are similar to regular expressions. This means that ^$()%.[]*+-? characters have special meaning, such as . matching any character. To search for those characters themselves, they need to be escaped by prefixing a %

For piped links, both the target article name as well as the displayed text are searched for matches. External links are not searched for matches.

B Tip: To make a letter in a search pattern case-insensitive, put both the upper-case and lowercase letter inside square-brackets, i.e. [Aa]pple will match both An apple is... and Apples are....

Examples

Europe

{{Transclude selected current events|Europe}}

No recent news

Europe (as portal component that is only displayed when there is news; limited to a maximum of 4 items)

{{Transclude selected current events|Europe|header={{Box-header color|In the news}}|max=4}}

United Kingdom

{{Transclude selected current events|United Kingdom}}
No recent news

Europe OR United Kingdom

{{Transclude selected current events|Europe|United Kingdom}}
No recent news

Europe AND United Kingdom

{{Transclude selected current events|Europe.*United Kingdom|United Kingdom.*Europe|days=10}}
No recent news

United Kingdom AND NOT Australia

{{Transclude selected current events|United Kingdom|not=Australia}}
No recent news

SomethingWithNoMatches

{{Transclude selected current events|SomethingWithNoMatches}}
No recent news

TemplateData

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Transclude selected current events in articles based on its TemplateData. TemplateData for Transclude selected current events This templates transcludes current events on specified topics from the daily subpages of Portal:Current Events. Can use Lua search patterns. Template parameters This template prefers inline formatting of parameters. Parameter Description Type Status Search Pattern (unnamed) 1 Pattern to search for (multiple instances separated with pipes) Default (empty) Example Europe.*United Kingdom String required Not not Pattern to exclude (multiple instances use notX) Default (empty) Example not=Africa, not2=Asia String optional Days days Number of days back to search (from today) Default 30 Example days=45 Date suggested Max max Maximum number of values to display Default 6 Example max=10 Number optional None none Wikitext to display if no results found Default No recent news Example none='''Oops.''' Nothing found. Content optional Dates dates Set date format to use MDY instead of DMY Default (empty) Example dates=mdy String optional More more Wikitext for bottom of listing Default (empty) Example more=[[/currentevents|See more]], more=yes Content optional

See also

• {{Template cache}} – companion template