Module Attributes via URL

Posted by ErichSteinboeck on 28 Jun 2008 17:32, last edited by Venryx on 16 Dec 2012 00:52

Tags: attributes dynamic module parameters url

For most Wikidot module calls you can specify (module-specific) attributes (names and values) on the [[module …]] call. An example would be [[module PageTree depth="1"]], where “depth” is the attribute name and “1” its attribute value.

Unspecified attributes take on their default values.

Some of those attributes, if either

• not specified on the [[module …]] call, or
• for recently changed modules ListPages and PageCalendar, specified with the special parameter value “@URL”

can have their attribute values specified dynamically via the calling URL (Uniform Resource Locator).

How it Works

The syntax for dynamically specifying module attribute values via the calling URL is
http://wiki-name.wikidot.com/page-name/attribute-name/attribute-value, where

• wiki-name is the name of your Wiki
• page-name is the name of the page, where the call to the module (whose attribute you'd like to specify) is coded,
• attribute-name is the name of the attribute you'd like to specify
• attribute-value is the value that attribute-name should take on

Wikidot itself uses URL-specified attributes in many places. For example:

• Search. Module “Search” has an attribute “q” (whose value is the string that Search should search for), that normally isn't specified on the [[module Search]] call. As the page search:site usually contains a call to [[module Search]], you can call http://wiki-name.wikidot.com/search:site/q/search-value to search for the string search-value.
  
  
• Pagination. Modules like ForumCategory, ListPages, or Search that support automatic pagination use attribute “p” to specify the number of the page to display (…page-name/p/page-nr)
  
  
• Redirect. If attribute “noredirect” specified via the URL as …page-name/noredirect/true module Redirect will not redirect.

Which Module Attributes Can be Specified Dynamically?

Not all module attributes can have their attribute values specified dynamically. To find out which can, see the following list:

	Attribute Can be Specified via URL1
Module2	Yes	No3
Comments	comments	hide, title
Feed	module_body	limit, offset, src
FlickrGallery	contentOnly, disableBrowsing, groupId, groupUrl, limitPages, pageNumber, perPage, photosetId, size, sort, tagMode, tags, userName
ForumCategory	c, p, sort
ForumNewThread	c, title
ForumStart	hidden
ForumThread	t
FrontForum	category, feed, feedDescription, feedTitle, limit, module_body, offset
ListPages	date4, limit5, nextBy6, order7, p, perPage8, previousBy9, t, tag10, tags11, tagTarget12, created_by13, urlAttrPrefix	appendLine, categories, category, module_body, prependLine, rss, rssTitle, separate, skipCurrent
ManageSite	start
Members	from	group, showSince
MiniActiveThreads		limit
MiniRecentPosts		categoryId, limit
MiniRecentThreads		limit
NewPage		button, category, format, size, style, template
NextPage	by
PageCalendar	date, tag14, tags15, urlAttrPrefix	categories, category, startPage, targetPage
Pages		category, details, limit, order, preview
PagesByTag	category, t, tag
PageTree	depth, root, showRoot
PetitionAdmin	withoutBox
PetitionList	id, limit
PreviousPage	by
Rate	pageId
RatedPages	maxRating, minRating, order	category, comments, limit
Redirect	destination, noredirect
Search	a, mini, p, q
SearchAll	a, p, q
SearchUsers	p, q
SignPetition	confirm, id
SimpleToDo	id
SitesListByTag	lang, tag, title
TagCloud		categories, category, limit, maxColor, maxFontSize, minColor, minFontSize, target
ThemePreviewer	noUi, theme_id

Example

This example shows how you can let users choose a page for which they'd like to display a “PageTree” site map.

To see the different results, click on the How-To Topics, Community How-To's, and Welcome links shown.

What you type …	What you get …
Show site map for top-level page \ [/howto:module-attributes-via-url/root/howtotopics:page-content How-To Topics], \ [/howto:module-attributes-via-url/root/howto:howto-list Community How-To's], \ [/howto:module-attributes-via-url/root/start/depth/1 Welcome] (first level only) [[module PageTree showRoot="yes"]]	Show site map for top-level page How-To Topics, Community How-To's, Welcome (first level only)

Links

For an application of this idea see Sortable List of Pages

Backlinks

• Create Sortable List of Pages
• How-To "Module Attributes via URL"

Author

ErichSteinboeck. Please visit his/her userPage.

---

Related articles

• Subscribe To Community Sites And Forum Changes Via Feedblitz
• Rename Existing Site
• Use Hash Magic Urls for option buttons
• Create a fully functional Blog
• Override Inline Styles With CSS
• Iframe Link

Comments

Module attributes via URL - ListPages offset ?

gerdami 16 Jan 2009 21:53

Erich,
Have you found a way to simulate the offset attribute which is available with the Feed module but not with the ListPages module ?

---

gerdami - Visit Handbook en Français - Rate this howto:import-simple-excel-tables-into-wikidot up!

Module attributes via URL - ListPages offset ?

ErichSteinboeck 17 Jan 2009 12:42

> a way to simulate the offset attribute which is available with the Feed module
Only in a rather crude way. Back in June last year I posted a suggestion in a thread that discussed how to break up ListPages output into chunks.

What does it mean " Specify "@URL" as the module tag parameter value"

skydiver000 28 Sep 2012 14:56

I tried to pass tag via URL

http://sky-tests.wikidot.com/last-pages/tag/hi

it did not work

tha only parameter I can pass is "p", like

http://sky-tests.wikidot.com/last-pages/p/4

how can I pass "created_at" ?

like

http://sky-tests.wikidot.com/last-pages/created_at/last%201%20week
http://sky-tests.wikidot.com/last-pages/created_at/last%204%20week

nevermind, I think I got it

[[module ListPages separate="no" tag="@URL" perPage="5"  created_at="@URL"]]
* %%title_linked%%
[[/module]]

Last edited on 28 Sep 2012 15:08 by skydiver000 Show more

Footnotes

1. The list includes attributes that aren't documented officially

2. The list includes modules that aren't documented officially

3. Although some of these attributes (e. g. MiniRecentPosts or TagCloud attributes) are read in via URL, nevertheless they don't work properly when specified via URL

4. Specify "@URL" as the module tag parameter value

5. Specify "@URL" as the module tag parameter value

6. Specify "@URL" as the module tag parameter value

7. Specify "@URL" as the module tag parameter value

8. Specify "@URL" as the module tag parameter value

9. Specify "@URL" as the module tag parameter value

10. Specify "@URL" as the module tag parameter value

11. Specify "@URL" as the module tag parameter value

12. Specify "@URL" as the module tag parameter value

13. Specify "@URL" as the module tag parameter value

14. Specify "@URL" as the module tag parameter value

15. Specify "@URL" as the module tag parameter value