====== Comment intégrer pxxo dans dokuwiki ======

^ Download | {{fr:dokuwiki:plugin-pxxo.tar.gz|plugin-pxxo.tar.gz}} |

Il est possible d'insérer relativement simplement des widgets pxxo dans les pages d'un site dokuwiki. Il faut pour cela installer le [[http://wiki.splitbrain.org/plugin:pxxo|plugin pxxo]] puis utiliser la syntaxe suivante dans votre page wiki là où vous désirez insérer le widget :


<code xml>
<pxxo widget="Pxxo_Widget_HelloWorld">
  <params>
    <montexte>Bla bla bla</montexte>
    <theme>blue</theme>
  </params>
</pxxo>
</code>

La liste des paramètres doit être exprimée dans un format XML compris par le package [[http://www.pear.php.net/package/XML_Serializer|PEAR::XML_Serializer]]. Voila par exemple comment exprimer un tableau multi-dimensionnel que voici :
<code php>
$params['width']  = '250px';
$params['height'] = '260px';
$params['controls'] = array('GSmallZoomControl', 'GMapTypeControl');
</code>

Voici ce qu'il faut écrire pour avoir l'équivalent en XML :

<code xml>
  <params>
    <width>250px</width><height>260px</height>
    <controls>GSmallZoomControl</controls>
    <controls>GMapTypeControl</controls>
  </params>
</code>


Voici un exemple un peu plus plus complexe, en php :
<code php>
$params['items']['folder1']['parent'] = null;
$params['items']['folder1']['name']   = 'Dossier1';
$params['items']['folder1']['order']  = 0;
$params['items']['folder1']['type']   = 'folder';

$params['items']['folder2']['parent'] = 'folder1';
$params['items']['folder2']['name']   = 'Dossier2';
$params['items']['folder2']['order']  = 1;
$params['items']['folder2']['type']   = 'folder';

$params['items']['folder3']['parent'] = 'folder2';
$params['items']['folder3']['name']   = 'Dossier3';
$params['items']['folder3']['order']  = 0;
$params['items']['folder3']['type']   = 'folder';
</code>
Voici ce qu'il faut écrire pour avoir l'équivalent en XML :
<code xml>
<params>
    <items>
        <folder1>
            <parent />
            <name>Dossier1</name>
            <order>0</order>
            <type>folder</type>
        </folder1>
        <folder2>
            <parent>folder1</parent>
            <name>Dossier2</name>
            <order>1</order>
            <type>folder</type>
        </folder2>
        <folder3>
            <parent>folder2</parent>
            <name>Dossier3</name>
            <order>0</order>
            <type>folder</type>
        </folder3>
    </items>
</params>
</code>





===== Examples =====

^ Nom du widget ^ Rendu ^ Wiki code ^
| HelloWorld | <pxxo widget="Pxxo_Widget_HelloWorld">
  <params>
    <montexte>Bla bla bla</montexte>
    <theme>blue</theme>
  </params>
</pxxo> | <code xml><pxxo widget="Pxxo_Widget_HelloWorld">
  <params>
    <montexte>Bla bla bla</montexte>
    <theme>blue</theme>
  </params>
</pxxo></code>|
| HelloWorld (avec une erreur de syntaxe) | <pxxo widget="Pxxo_Widget_HelloWorld">
  <params>
    <montexteBla bla bla</montexte>
    <theme>blue</theme>
  </params>
</pxxo> | <code xml><pxxo widget="Pxxo_Widget_HelloWorld">
  <params>
    <montexteBla bla bla</montexte>
    <theme>blue</theme>
  </params>
</pxxo></code>|
| GoogleMaps | <pxxo widget="Pxxo_Widget_GoogleMaps">
  <params>
    <key>ABQIAAAAsHVA1uQhfTfkYV-IfWkNLhSNt7z7u_GeIa9L7vF_w14j5JokQhSqookYtStELYvgzJ9XDbU1sKpgXw</key>
    <width>250px</width><height>260px</height>
    <controls>GSmallZoomControl</controls>
    <controls>GMapTypeControl</controls>
  </params>
</pxxo> | <code xml><pxxo widget="Pxxo_Widget_GoogleMaps">
  <params>
    <key>ABQIAAAAsHVA1uQhfTfkYV-IfWkNLhSNt7z7u_GeIa9L7vF_w14j5JokQhSqookYtStELYvgzJ9XDbU1sKpgXw</key>
    <width>250px</width><height>260px</height>
    <controls>GSmallZoomControl</controls>
    <controls>GMapTypeControl</controls>
  </params>
</pxxo></code> |
| TreeView | <pxxo widget="Pxxo_Widget_TreeView">
<params>
    <items>
        <folder1>
            <parent />
            <name>Dossier1</name>
            <order>0</order>
            <type>folder</type>
        </folder1>
        <folder2>
            <parent>folder1</parent>
            <name>Dossier2</name>
            <order>1</order>
            <type>folder</type>
        </folder2>
        <item1>
            <parent>folder1</parent>
            <name>This is an item</name>
            <order>2</order>
            <type>item</type>
        </item1>
        <folder3>
            <parent>folder2</parent>
            <name>Dossier3</name>
            <order>0</order>
            <type>folder</type>
        </folder3>
    </items>
</params>
</pxxo> | <code xml><pxxo widget="Pxxo_Widget_TreeView">
<params>
    <items>
        <folder1>
            <parent />
            <name>Dossier1</name>
            <order>0</order>
            <type>folder</type>
        </folder1>
        <folder2>
            <parent>folder1</parent>
            <name>Dossier2</name>
            <order>1</order>
            <type>folder</type>
        </folder2>
        <item1>
            <parent>folder1</parent>
            <name>This is an item</name>
            <order>2</order>
            <type>item</type>
        </item1>
        <folder3>
            <parent>folder2</parent>
            <name>Dossier3</name>
            <order>0</order>
            <type>folder</type>
        </folder3>
    </items>
</params>
</pxxo></code> |