Misc. Functions - Revision history

LWC: /* Misc. Functions */ No topic id (as written in lib-plugins.php)

2008-12-25T18:55:16Z

‎Misc. Functions: No topic id (as written in lib-plugins.php)

LWC: /* Misc. Functions */ No space

2008-12-25T18:49:22Z

‎Misc. Functions: No space

LWC at 18:47, 25 December 2008

2008-12-25T18:47:51Z

LWC: Added note

2008-12-25T18:47:42Z

Added note

LWC: Added space and improved phrase

2008-12-25T18:44:27Z

Added space and improved phrase

Tomw at 14:42, 2 July 2004

2004-07-02T14:42:44Z

Tomw at 14:26, 2 July 2004

2004-07-02T14:26:02Z

New page

The following is a list of (optional) functions for misc. purposes.</p>

<table cellpadding="2" cellspacing="2" border="1" width="90%" align="center">
<caption align="bottom">Table 9. Misc. functions</caption>
<tr>
<th valign="top">Function</th>
<th valign="top">Description of Function</th>
</tr>
<tr>
<td valign="top" class="codeheader">plugin_centerblock_<plugin name></td>
<td valign="top" class="code">Plugins can display a block in the site's center area, i.e. among the stories. This function is called several times during rendering of the site's index page. The parameters will tell the plugin where on the index page the block would appear.<br>
Parameters are <code>where</code> (1 = top of page, 2 = after the featured story, 3 = bottom of page), <code>page number</code> and the <code>topic id</code>. <code>where</code> can also be 0 which means that the plugin can take over the entire page if it wants to (in this case, it will have to return the HTML for the <em>entire page</em>, i.e. including site header and footer).<br>
The function should return the complete HTML for the block (including header and footer) or an empty string.</td>
</tr>
<tr>
<td valign="top" class="codeheader">plugin_getheadercode_<plugin
name></td>
<td valign="top" class="code">Plugins may add additional lines to the site's <code><head></code> tag by implementing this function, e.g. Javascript functions or additional Meta tags.<br>
The function should return a concatenated string of all its extra header code.</td>
</tr>
<tr>
<td valign="top" class="codeheader">plugin_whatsnewsupported_<plugin name></td>
<td valign="top" class="code">Plugins can add their own section to Geeklog's What's New block by implementing this and the following function.<br>
The function should return an array of 2 strings. The first string is used as the headline for the plugin's section in What's New and the second string is used to indicate the timespan that the entries in this section cover (e.g. "last 2 weeks").</td>
</tr>
<tr>
<td valign="top" class="codeheader">plugin_getwhatsnew_<plugin name></td>
<td valign="top" class="code">This function should return the actual new entries to be listed in the What's New block (as an array) or a string to be displayed in case there are no new entries.</td>

</tr>
</table>

@@ Line 12: / Line 12: @@
          <td valign="top" class="codeheader">plugin_centerblock_&lt;plugin name&gt;</td>
          <td valign="top" class="code">Plugins can display a block in the site's center area, i.e. among the stories. This function is called several times during rendering of the site's index page. The parameters will tell the plugin where on the index page the block would appear.<br>
-Parameters are <code>where</code> (1 = top of page, 2 = after the featured story, 3 = bottom of page and 0 = full page), <code>page</code> (page number) and the <code>topic</code> (topic id).
+Parameters are <code>where</code> (1 = top of page, 2 = after the featured story, 3 = bottom of page and 0 = full page), <code>page</code> (page number) and the <code>topic</code> (topic id. None = means the user is in the front page).
 <br>As mentioned, the first parameter, <code>where</code>, can also be 0 which means that the plugin can take over the entire page if it wants to and thus make the CMS just serve as infrastructure for the plugin (of course, in this case it will have to return the HTML for the <em>entire page</em>, i.e. including site header and footer).<br>
 The function should return the complete HTML for the block (including header and footer) or an empty string.</td>

@@ Line 12: / Line 12: @@
          <td valign="top" class="codeheader">plugin_centerblock_&lt;plugin name&gt;</td>
          <td valign="top" class="code">Plugins can display a block in the site's center area, i.e. among the stories. This function is called several times during rendering of the site's index page. The parameters will tell the plugin where on the index page the block would appear.<br>
-Parameters are <code>where</code> (1 = top of page, 2 = after the featured story, 3 = bottom of page and 0 = full page), <code>page</code> (page number) and the <code>topic id</code>.
+Parameters are <code>where</code> (1 = top of page, 2 = after the featured story, 3 = bottom of page and 0 = full page), <code>page</code> (page number) and the <code>topic</code> (topic id).
 <br>As mentioned, the first parameter, <code>where</code>, can also be 0 which means that the plugin can take over the entire page if it wants to and thus make the CMS just serve as infrastructure for the plugin (of course, in this case it will have to return the HTML for the <em>entire page</em>, i.e. including site header and footer).<br>
 The function should return the complete HTML for the block (including header and footer) or an empty string.</td>

← Older revision		Revision as of 18:47, 25 December 2008
Line 1:		Line 1:
−	The following is a list of (optional) functions for misc. purposes.	+	The following is a list of (optional) functions for misc. purposes:

	==Misc. Functions==		==Misc. Functions==

@@ Line 1: / Line 1: @@
-The following is a list of (optional) functions for misc. purposes.</p>
+The following is a list of (optional) functions for misc. purposes.
    <table cellpadding="2" cellspacing="2" border="1" width="90%" align="center">
@@ Line 10: / Line 12: @@
          <td valign="top" class="codeheader">plugin_centerblock_&lt;plugin name&gt;</td>
          <td valign="top" class="code">Plugins can display a block in the site's center area, i.e. among the stories. This function is called several times during rendering of the site's index page. The parameters will tell the plugin where on the index page the block would appear.<br>
-Parameters are <code>where</code> (1 = top of page, 2 = after the featured story, 3 = bottom of page and 0 = full page), <code>page number</code> and the <code>topic id</code>.
+Parameters are <code>where</code> (1 = top of page, 2 = after the featured story, 3 = bottom of page and 0 = full page), <code>page</code> (page number) and the <code>topic id</code>.
 <br>As mentioned, the first parameter, <code>where</code>, can also be 0 which means that the plugin can take over the entire page if it wants to and thus make the CMS just serve as infrastructure for the plugin (of course, in this case it will have to return the HTML for the <em>entire page</em>, i.e. including site header and footer).<br>
 The function should return the complete HTML for the block (including header and footer) or an empty string.</td>

← Older revision		Revision as of 14:42, 2 July 2004
Line 30:		Line 30:
	</tr>		</tr>
	</table>		</table>
		+
		+	[[Category:Plugin Development]]