Loading...
 
Skip to main content

Plugin Include

Use this wiki plugin to include the contents of a Wiki page inside another page (it must be a Wiki page located in the Wiki section of your Tiki, as other types of pages won't work yet!). This is a form of Wiki transclusion

Parameters

Include a portion of another wiki page
Introduced in Tiki 1. Required parameters are in bold.
Go to the source code
Preferences required: wikiplugin_include

Parameters Accepted Values Description Default Since
page pagename Name of the source wiki page (which contains the included portion) 1
start When only a portion of the page should be included, full text of the line after which inclusion should start 1
stop When only a portion of the page should be included, full text of the line before which inclusion should end 1
max_chars_included int Limit the length of the included text 20.0
max_inclusions text Maximum amount of times the same page can be included. Defaults to 5 5 18.2
pagenotapproved_text text Text to show when the page exists but no version is approved. 18.0
nopage_text text Text to show when the page selected to be included is not found anymore. 6.0
pagedenied_text text Text to show when the page exists but the user has insufficient permissions to see it. 6.0
linkoriginal (blank)
y
n
Add a "Read more" link at the end of included content, linking to the original page. (shows "Read More" by default) n 18.0
linkoriginal_text text Label of the button linking to the source page (if it is displayed) 18.0
recursive_include_warning y
n
Option to warn when we include a page within itself. y
page_replace_icon (blank)
y
n
Option to show the replace page icon, for the included page to be replaced by original wiki text. Depends on the "edit icons" settings.
page_version int Get the version of page included 26.0
page_edit_icon (blank)
y
n
Option to show the edit icon for the included page (shown by default). Depends on the "edit icons" settings. 12.1
parse_included_page (blank)
y
n
Parse the page to be included before adding it to the parent page. This will help if html pages are included in wiki pages or vice versa, but will cause issues with the wiki table of contents. n 18.2

Example

This example transcludes (or includes) portions of the page Tiki2 between the strings Authentication and OpenID.

This code:

Copy to clipboard
{include page="Tiki2" start="!!!# Authentication" stop="!!!!# OpenID"}


Would produce on this site:

Authentication has received a major enhancement.

Some new options

  • Use login as email
  • Crypt passwords method
  • User trackers at registration


 Partial inclusions
start and stop must represent the entire line, not just a portion of a line.

Limitations

You can not include a same page or a same page extract more than 5 times on one page. If you need to exceed 5 times you will have to modify the plugin and change the value of max_inclusions . Starting in Tiki 18.2, there is a parameter to do so.


Created by system. Last Modification: Monday 29 July, 2019 11:05:04 GMT-0000 by Yves Kipondo.