<?php/** * Piwik - Open source web analytics *  * @link http://piwik.org * @license http://www.gnu.org/licenses/gpl-3.0.html Gpl v3 or later * @version $Id: ExamplePlugin.php 622 2008-09-04 23:24:26Z matt $ *  * @package Piwik_ExamplePlugin */class Piwik_ExamplePlugin extends Piwik_Plugin{	public function getInformation()	{		return array(			'name' => 'Example Plugin',			'description' => 'Example Plugin: This plugin shows how to create a very simple plugin, that exports two widgets in the Dashboard.',			'author' => 'Piwik',			'homepage' => 'http://piwik.org/',			'version' => '0.1',		);	}}// we register the widgets so they appear in the "Add a new widget" window in the dashboardPiwik_AddWidget('ExamplePlugin', 'exampleWidget', 'Example widget');Piwik_AddWidget('ExamplePlugin', 'blogMatthieu', 'Blog matthieu RSS');class Piwik_ExamplePlugin_Controller extends Piwik_Controller{		/**	 * Go to /piwik/?module=ExamplePlugin&action=helloWorld to execute this method	 *	 */	function helloWorld()	{		echo "Hello world! <br />";		echo "Happy coding with Piwik :)";	}		/**	 * See the result on piwik/?module=ExamplePlugin&action=exampleWidget	 * or in the dashboard > Add a new widget 	 *	 */	function exampleWidget()	{		echo "Hello world! <br> You can output whatever you want in widgets, and put them on dashboard or everywhere on the web (in your blog, website, etc.).		<br>Widgets can include graphs, tables, flash, text, images, etc.		<br>It's very easy to create a new plugin and widgets in Piwik. Have a look at this example file (/plugins/ExamplePlugin/ExamplePlugin.php).		<br><i>Happy coding!</i>";	}	/**	 * Embed Matt's blog using widgetbox.com widget code	 */	function blogMatthieu()	{		echo '		<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=8,0,0,0" type="application/x-shockwave-flash" width="400px" height="338px" id="InsertWidget_3fe0d93d-bae5-42f9-bec4-4235cb6285a8" align="middle">			<param name="movie" value="http://widgetserver.com/syndication/flash/wrapper/InsertWidget.swf?appId=3fe0d93d-bae5-42f9-bec4-4235cb6285a8"/>			<param name="quality" value="high" />			<param name="wmode" value="transparent" />			<param name="menu" value="false" />		<embed src="http://widgetserver.com/syndication/flash/wrapper/InsertWidget.swf?appId=3fe0d93d-bae5-42f9-bec4-4235cb6285a8"  name="InsertWidget_3fe0d93d-bae5-42f9-bec4-4235cb6285a8"  width="400px" height="338px" quality="high" menu="false" pluginspage="http://www.macromedia.com/go/getflashplayer" type="application/x-shockwave-flash" wmode="transparent" align="middle" /> </object>		<img style="visibility:hidden;width:0px;height:0px;" border="0" width="0" height="0" src="http://runtime.widgetbox.com/syndication/track/3fe0d93d-bae5-42f9-bec4-4235cb6285a8.gif" />		';	}		/**	 * This method displays a text containing an help about "How to build plugins for Piwik".	 * This help is then used on http://dev.piwik.org/trac/wiki/Plugins/GlobalFunctions	 *	 */	function index()	{		$out = '';		$out .= '<i>This page aims to list the different functions you can use when programming plugins for Piwik.</i><br>';		$out .= '<b>Be careful, the following APIs may change in the near future as Piwik is still in development.</b><br>';				$out .= '<h2>General</h2>';		$out .= '<h3>Accessible from your plugin controller</h3>';				$out .= '<code>$this->date</code> = current selected <b>Piwik_Date</b> object (<a href="http://piwik.org/documentation/Piwik_Helper/Piwik_Date.html">documentation</a>)<br/>';		$out .= '<code>$period = Piwik_Common::getRequestVar("period");</code> - Get the current selected period<br/>';		$out .= '<code>$idSite = Piwik_Common::getRequestVar("idSite");</code> - Get the selected idSite<br/>';		$out .= '<code>$site = new Piwik_Site($idSite);</code> - Build the Piwik_Site object (<a href="http://piwik.org/documentation/Piwik_Site/Piwik_Site.html">documentation</a>)<br/>';		$out .= '<code>$this->str_date</code> = current selected date in YYYY-MM-DD format<br/>';				$out .= '<h3>Misc</h3>';		$out .= '<code>Piwik_AddMenu( $mainMenuName, $subMenuName, $url );</code> - Adds an entry to the menu in the Piwik interface (See the example in the <a href="http://dev.piwik.org/trac/browser/trunk/plugins/UserCountry/UserCountry.php#L146">UserCountry Plugin file</a>)<br/>';		$out .= '<code>Piwik_AddWidget( $pluginName, $controllerMethodToCall, $widgetTitle );</code> - Adds an entry to the menu in the Piwik interface (See the example in the <a href="http://dev.piwik.org/trac/browser/trunk/plugins/UserCountry/UserCountry.php#L143">UserCountry Plugin file</a>)<br/>';		$out .= '<code>Piwik::prefixTable("site")</code> = <b>' . Piwik::prefixTable("site") . '</b><br/>';						$out .= '<h2>User access</h2>';		$out .= '<code>Piwik::getCurrentUserLogin()</code> = <b>' . Piwik::getCurrentUserLogin() . '</b><br/>';		$out .= '<code>Piwik::isUserHasSomeAdminAccess()</code> = <b>' . self::boolToString(Piwik::isUserHasSomeAdminAccess()) . '</b><br/>';		$out .= '<code>Piwik::isUserHasAdminAccess( array $idSites = array(1,2) )</code> = <b>' . self::boolToString(Piwik::isUserHasAdminAccess(array(1,2) )) . '</b><br/>';		$out .= '<code>Piwik::isUserHasViewAccess( array $idSites = array(1) ) </code> = <b>' . self::boolToString(Piwik::isUserHasViewAccess(array(1))) . '</b><br/>';		$out .= '<code>Piwik::isUserIsSuperUser()</code> = <b>' . self::boolToString(Piwik::isUserIsSuperUser()) . '</b><br/>';				$out .= '<h2>Execute SQL queries</h2>';		$txtQuery = "SELECT token_auth FROM ".Piwik::prefixTable('user')." WHERE login = ?";		$result = Piwik_FetchOne($txtQuery, array('anonymous'));		$out .= '<code>Piwik_FetchOne("'.$txtQuery.'", array("anonymous"))</code> = <b>' . var_export($result,true) . '</b><br/>';		$out .= '<br>';				$query = Piwik_Query($txtQuery, array('anonymous'));		$fetched = $query->fetch();		$token_auth = $fetched['token_auth'];				$out .= '<code>$query = Piwik_Query("'.$txtQuery.'", array("anonymous"))</code><br>';		$out .= '<code>$fetched = $query->fetch();</code><br>';		$out .= 'At this point, we have: <code>$fetched[\'token_auth\'] == <b>'.var_export($token_auth,true) . '</b></code><br/>';		  		$out .= '<h2>Example Sites information API</h2>';		$out .= '<code>Piwik_SitesManager_API::getSitesWithViewAccess()</code> = <b><pre>' .var_export(Piwik_SitesManager_API::getSitesWithViewAccess(),true) . '</pre></b><br/>';		$out .= '<code>Piwik_SitesManager_API::getSitesWithAdminAccess()</code> = <b><pre>' .var_export(Piwik_SitesManager_API::getSitesWithAdminAccess(),true) . '</pre></b><br/>';		$out .= '<h2>Example API  Users information</h2>';		$out .= 'View the list of API methods you can call on <a href="http://dev.piwik.org/trac/wiki/API/Reference#Methods">API reference</a><br/>';		$out .= 'For example you can try <code>Piwik_UsersManager_API::getUsersSitesFromAccess("view");</code> or <code>Piwik_UsersManager_API::deleteUser("userToDelete");</code><br/>';				$out .= '<h2>Smarty plugins</h2>';		$out .= 'There are some builtin plugins for Smarty especially developped for Piwik. <br>				You can find them on the <a href="http://dev.piwik.org/trac/browser/trunk/core/SmartyPlugins">SVN at /trunk/core/SmartyPlugins</a>. <br>				More documentation to come about smarty plugins.<br/>';				echo $out;	}		static private function boolToString($bool)	{		return $bool ? "true" : "false";	}}