- VW3
- Namespace Manager
Return to current revision
General Differences
- changed the meta description
-
-
A namespace is the largest article container in VaultWiki apart from VaultWiki itself. The namespace functionality was added in the first release, then called CES NuWiki Special Pages, and is the basic component on which the rest of... -
+
A namespace contains articles. A namespace is equivalent to a specific parent forum and its respective child forums.
-
Differences in Content
-
-
A [b]namespace[/b] is the largest article container in VaultWiki apart from VaultWiki itself. The namespace functionality was added in the first release, then called [help]CES NuWiki Special Pages[/help], and is the basic component on which the rest of the modification builds. A namespace is generally equivalent to any top-level forum with a [help]Vault Type[/help], usually sharing its title and forum ID.
In each namespace, more than one article cannot have the same article title, with the exception of an [help]Island[/help]. Every namespace has a unique BB-Code for linking from any article to an article in the BB-Code's namespace. -
+
A [b]namespace[/b] contains articles. A namespace is equivalent to a specific parent forum and its respective child forums. -
-
-
[h=2]Basic Namespaces[/h]
By default, the VaultWiki will expect at least four (4) namespaces in order to for all of its features to work correctly. This includes 1 main article namespace, 1 Special namespace, 1 Template namespace, and 1 Help namespace. If the optional Forum Headers feature is used, then a fifth Header namespace is also required. -
+
In each namespace, each article title in a Wiki forum is unique to that article. Every namespace has a unique prefix to the title variable in article URLs, usually the Title of the namespace. The definition of unique namespaces makes it possible for VaultWiki to be selective with regards to the article metadata it stores in memory on each page load. -
-
-
[h=3]Main Namespace[/h]
The main namespace is the default namespace, specified by the following values:
[php]$vbulletin->options['ces_default_forumid'][/php]
Articles in the main namespace can be accessed without prefixing the namespace title in the URL. However, the main namespace is variable in [help]Multidomain Wiki[/help]s, allowing different domains to use different default settings. -
+
If you visit the [help]Namespace Manager[/help], you will see a list of some pre-defined namespaces. These namespaces, as well as others that can be installed using modifications, have special functions. -
-
-
[h=3]Special Namespace[/h]
The Special namespace contains dynamic articles with statistical information about the rest of VaultWiki, called [help]Special page[/help]s. In general, the Special namespace is for administrative and statistical use only. -
+
[h=2]Island[/h]
This is not really a namespace. For more information about Wiki Islands, see the appropriate section of [help=Wiki forums#Wiki_Island]Wiki forums[/help]. -
-
-
[h=3]Template Namespace[/h]
The Template namespace contains standardized text selections which can be included and modified in many articles at once quickly and easily by their authors. Editing a [help]template[/help] will update the content of each other article that makes use of the template. -
+
[h=2]Special[/h]
The Special namespace contains [help=Special pages]abstract pages[/help], meaning pages that are not forum threads. These pages provide statistical information about your VaultWiki installation. -
-
-
[h=3]Help Namespace[/h]
The Help namespace contains articles describing the technical features of VaultWiki and its modifications and how to properly use those features. A complete list of Help topics can be accessed in [help=Contents]Help:Contents[/help] (once documentation is completed). -
+
[h=2]Template[/h]
The Template namespace contains pages that can be included into articles that your users write. For example, if you frequently use the same text or formatting, creating a [help]Template[/help] can save your users from having to needlessly duplicate this content. -
-
-
[h=2]Managing Namespaces[/h]
Namespaces can be added manually or by installing further modifications to VaultWiki. To manually add a namespace, simply set a forum's Vault Type to Wiki-type and make sure it does not have a Parent Forum. A namespace should ideally be open for posting, and Act as a Forum (i.e. not a vBulletin Category). When saving the namespace Forum, all child threads are automatically updated with the Namespace ID information. Although the Namespace ID should be available via the thread's [i]namespaceid[/i] key, it can also be retrieved by backtracing the forum's Parent List using this function:
[php]$thread['namespaceid'] = $vault->fetch_namespaceid($thread['forumid']);[/php] -
+
[h=2]Help[/h]
The Help namespace contains, or will contain, copies of this documentation. -
-
-
If a namespace is ever corrupted, some statistics may not be calculated properly and articles may become completely inaccessible. If this occurs you should rebuild the Wiki [help]Article List[/help] to fix the access problems, as well as the [help]Link Cache[/help] to fix statistics. -
+
[h=2]Header[/h]
The Header namespace contains [help]forum header[/help] pages. These pages appear at the top of certain forums and can be as brief or as detailed as you wish. They are intended to provide your users with additional information about the topics discussed in each forum. -
-
-
In order to facilitate proper article linking among namespaces, or if the default namespace would be modified by a multi-domain setup, the [help]Tag Map[/help] correlates namespaces to their respective BB-Code tags. -
+
[h=2]Book[/h]
The Book namespace contains pages that serve as introductions to collections of articles. This namespace allows you to group several articles from other namespaces so that "turn the page" capabilities between them are automatically added and maintained. For more information, see [help]Using Books[/help]. -
-
-
As of VaultWiki 2.x, the namespace array is automatically built on instantiation of the [i]vB_CES_Vault[/i] class by searching vBulletin's forum cache for compatible forums:
[php]$vault->namespaces = array();
$vault->fetch_namespace_array();[/php] -
+
[h=2]Default[/h]
This namespace does not have any special function. For the most part, you should be creating all your article content here. You really should not be creating any additional namespaces unless otherwise instructed.