View source for Misc. Functions

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_&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>.
<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>
      </tr>
      <tr>
        <td valign="top" class="codeheader">plugin_getheadercode_&lt;plugin 
     name&gt;</td>
        <td valign="top" class="code">Plugins may add additional lines to the site's <code>&lt;head&gt;</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_&lt;plugin name&gt;</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_&lt;plugin name&gt;</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>

[[Category:Plugin Development]]