Differences

This shows you the differences between two versions of the page.

--- g2:featureset [2008/01/06 14:35] – vertical whitespace removal fgm
+++ g2:featureset [2020/11/23 17:23] (current) – external edit 127.0.0.1
@@ Line 19: / Line 19: @@
   * node/<nid> : the page for an individual G2 entry
   * taxonomy/term/<tid>[/0/feed] : the page or RSS feed for the entries in G2 (and elsewhere) matching a taxonomy term
 ====== Settings ======
@@ Line 24: / Line 25: @@
 Most settings are located in the feature blocks, but G2 also has a few global settings.
-  * Custom main page node, typically unpublished. Is used for the glossary home page, wrapped between two alphabars in the default theme
+  * Custom main page. Is used for the glossary home page, replaced by an alphabar if empty. Starting with the D5 version, it can be set in either of two ways:
+    * by providing the nid of an existing node, typically an unpublished story node. This is the default method in the 4.7 branch, and the simplest way to customize the module for beginners
+    * by providing the name of a node-generating function (starting with the D5 branch). This function must return a "node" object, which can contain:
+      * a title for the page. If missing, G2 will use its own default title
+      * a body for the page. If missing, G2 will replace it by an alphabar
+      * a nid, which should be zero
+    * in both cases, starting with the D5 branch, the validity of the parameter is tested: the nid or function must exist
   * Toggle activation of XML-RPC services
   * Toggle search hinting
@@ Line 33: / Line 40: @@
 The settings for the WOTD RSS feed are grouped with the settings for the WOTD block.
+The "generator function" mechanism introduced in D5 makes main page maintenance easier for sites using version tracking software : the page can be generated in the general site-specific module, where it can be backed up and versioned just like any other source code.
 ====== G2 XML-RPC API ======