Editing Wikisphere extensions


==Modules==
(each module is technically an autonomous extension)
{| class="wikitable"
|+
!name
!description
!required exensions
|-
|Wikisphere common
|Common methods required from the various Wikisphere extensions
|Semantic Mediawiki/PageForms
|-
|Wikisphere PageProperties
|Allows to easily edit display title, language and content model of a page. Provides support for SEO and published/draft state of pages
|Wikisphere common
|-
|Wikisphere PageOwnership
|Provides support for page ownership and attribution
|Wikisphere common
|-
|Wikisphere Subpages
|Provides the list of subpages on the navigation panel, a magic word to display subpages of a given page, and a special page to navigate through suppages
|none
|-
|Wikisphere FileInclusion
|A simple extension to display the content of authorized files within pages
|SyntaxHighlight (optionally)
|-
|Wikisphere PreloadContent
|(not yet developed) Automatically creates pages upon form submission based on the regular expressions
|
|}


==Configuration==
{| class="wikitable"
|+
!variable
!possible values
!description
|-
|$wgWikisphereUploadDisableWarnings
|true/false
|disable "was-deleted", "duplicate" and "duplicate-archive" warnings on file upload (requires the patches in the file [[Source code & patches/includes/upload/UploadBase.php|includes/upload/UploadBase.php]])
|-
|$wgWikisphereUploadUnderCurrentPage
|true/false
|upload images under the current page. E.g. A picture named "cover.png" will be uploaded in the path Book name/cover.png rather than without any path (as in standard WIKIs). This allows the use of generic name for pictures, which are by contrast characterized by their path. (requires the patches [[Source code & patches#Files.2FUpload|described here]])
|-
|$wgWikisphereAllowCreationRegularPages
|true/false
|if the extension Wikisphere PageOwnership is installed, regular users cannot create pages outside their owned pages. Setting this variable to true in combination with $wgWikisphereHandleDraftState set to "new" or "all" lets regulars users to create any page, at the same time leaving to moderators the power to publish them when appropriate
|-
|$wgWikisphereCreateOwnedPageRealName
|true/false
|if the extension Wikisphere PageOwnership is installed, automatically creates an owned page corresponding to the user's real name as soon as an user signs in
|-
|$wgWikisphereCreateOwnedPageTimestamp
|true/false
|if the extension Wikisphere PageOwnership is installed, automatically creates an owned page corresponding to the timestamp of the user's account creation as soon as an user signs in
|-
|$wgWikispherePostOnWikisphere
|true/false
|posts the semantic content on the global wikisphere.org database (front-end)
|-
|$wgWikisphereHandleDraftState
|none, new, all, owned
|requires the extension Wikisphere PageProperties. If set to "none" the pages don't need to be explicitly published through the page Properties (reachable from the dropdown of page actions, see picture ...) to be accessible to everybody. If set to "new" only new pages need to be explicitly published to be accessible to everybody. If set to "owned" only owned pages and sub-pages need to be published to be accessible to everybody or to be posted on the global  wikisphere.org database (front-end)
|}


==Magic Words / Parser functions==
{| class="wikitable"
|+
!name
!use case
!description
!extension
|-
|wikisphere_userpages
|<nowiki>{{#wikisphere_userpages: }}</nowiki>
|prints the list of pages owned by the logged-in user (to be used in forms, in order to create new pages under pages owned by the creator)
|Wikisphere PageOwnership
|-
|wikisphere_subpages
|<nowiki>{{#wikisphere_subpages: }}</nowiki>
|prints the list of subpages of a given page
|Wikisphere Subpages
|-
|noparse
|<nowiki>{{#noparse: <a href="">my link</a>}}</nowiki>
|can be used to print raw html within the page when [[mediawikiwiki:Manual:$wgRawHtml|$wgRawHtml]] is disabled
|Wikisphere common
|-
|hostname
|<nowiki>{{#hostname:}}</nowiki>
|prints the host name, currently used by [[Template:Pdf thumbnail|Pdf thumbnail]] to open display the pdf file from the pdf viewer of the browser
|Wikisphere common
|}


==Features==

<br />

===Wikisphere Common===

*Displays the list of forms on the left navigation panel
*outputs script global variables on page head
*implements "userCan" on behalf of other Wikisphere extensions
*displays "Powered by WikiSphere" icon
*implements magic words "noparse" and "hostname"
*implements basic functions required by other Wikisphere extensions<br /><br />

===PageProperties===

*implements the special page PageProperties in order to assign properties like display_title, language, published state, meta (Html metadata), and more, to any page
*displays the action "Properties" in the page's dropdown menu
*prints HTML metadata in the head of the page
*handles the link rendered in each page according to the saved display_title
*retrieves and saves the page's semantic data on the global Wikisphere database (if the variable  $wgWikispherePostOnWikisphere is enabled)

<br />
===PageOwnership===

*creates default owned pages (real name and account creation timestamp)
*displays the action "Ownership" in the page's dropdown menu
*displays the list of personal pages on the left navigation panel
*implements the parser function "wikisphere_userpages" to print the list of pages owned by the logged-in user
*implements the special page PageOwnership in order to assign admins, editors or readers to specific pages and their subpages


===Subpages===

*implements the parser function "wikisphere_subpages"
*displays the list of subpages of the current page on the left navigation panel
*implements the special page WikisphereSubpages in order to display and navigate through subpages of a given page


===Preload content===