~~NOTOC~~
====== Documentation OXML ======

<note>
{{ :software_help_128.png|}}
**__Documentation officielle du logiciel [[http://www.oxphp.com/oxml|OXML]]__**

Dernière version disponible: 4.0.3 //([[oxml/release]])//

Ce logiciel est édité par la société CREATY.
</note>

===== Installation =====

  - Téléchargez la dernière version du script : [[http://www.oxphp.com/oxml/oxml-latest-ion.zip|OXML avec Ioncube]] (PHP 5) | [[http://www.oxphp.com/oxml/oxml-latest-ion-4.zip|OXML avec Ioncube]] (PHP 4) | [[http://www.oxphp.com/oxml/oxml-latest-zend.zip|OXML avec Zend Optimiser]]
  - Décompressez le fichier ZIP et uploadez en mode binaire l'ensemble des fichiers sur votre serveur FTP
  - Effectuez un **CHMOD 777** sur les répertoires "**template**", "**data**", "**cache**" et sur le **répertoire racine d'installation** ((répertoire dans lequel est installé le script))
  - Effectuez un **CHMOD 666** sur les fichiers "**template/light.tpl**" et "**template/insense.tpl**"
  - Rendez-vous sur http://www.votresite.com/oxml.php
  - Suivez les instructions afin d'installer et configurer votre base de données MySQL

<note important>
Certains fichiers de OXML sont cryptés avec Ioncube ou Zend, suivant la version que vous souhaitez installer. Si vous avez choisi la version Zend, vous devez disposer de Zend Optimiser sur votre hébergement.

Vous **__devez obligatoirement transférer les fichiers sur votre hébergement en mode binaire__** (Binary Mode).
</note>

**Félicitations ! OXML est désormais installé sur votre site.**

  - Mettez à jour votre site en cliquant sur le bouton "Mettre à jour le site" et patientez.
  - Pour mettre à jour automatiquement les vidéos, les sponsors et votre site, vous devez mettre en place un crontab sur votre hébergement, pour appeler le fichier "cron.php" régulièrement. Une seule exécution de ce fichier par jour est nécessaire, de préférence entre 7h et 10h du matin.

Voici un exemple de crontab à placer :
<code bash>
30 7    * * *   root    lynx -dump 'http://www.domaine.com/cron.php?pass=XXXXXX' 2>&1 > /dev/null
</code>

Vous devez remplacer //XXXXXX// par le mot de passe OXML que vous avez choisi lors de l'installation.
Ce crontab exécute tous les jours à 7h30 le ficher "cron.php" via le programme lynx sous Linux.

===== Mise à jour =====

  * Voir la [[oxml/upgrade|procédure de mise à jour]]

===== Guide de démarrage rapide =====

  * Consulter le [[oxml/guide de démarrage rapide]] de OXML

===== Système de template =====

OXML dispose d'un système de template puissant et facile à prendre en main. Vous pouvez y intégrer votre propre code PHP et utiliser des "marqueurs" qui seront remplacés par les informations adéquates lors de la génération du site.

  * Voir le fonctionnement du [[oxml/template|système de template]]

2 templates sont fournis en guise d'exemple :
  * [[oxml/light.tpl|light.tpl]]
  * [[oxml/insense.tpl|insense.tpl]]

===== Gestion des sponsors =====

Les sponsors sont les fournisseurs des vidéos. Vous pouvez les activer et les désactiver à tout moment.

<note warning>Lorsque vous activez un sponsor, assurez-vous que vous avez bien indiqué vos identifiants sur le sponsor en question afin que ce dernier puisse vous reverser vos gains sur votre compte !</note>

L'adresse de destination lors d'un click sur la vidéo est indiquée lorsque vous cliquez sur le bouton "Afficher les paramètres" du sponsor.

===== Gestion des catégories =====

Créez librement autant de catégories que vous le souhaitez sur votre site vidéo. Une catégorie permet de regrouper les vidéos de votre choix, en fonction du sponsor ou de la catégorie du sponsor.

Après avoir créé une ou plusieurs catégories, vous devez y associer les catégories sponsors de votre choix.

Toutes les vidéos qui appartiennent aux catégories sponsors que vous avez sélectionné seront associées à VOTRE catégorie.

===== Outils de promotion =====

Vous souhaitez afficher les dernières vidéos ajoutées sur votre site vidéo sur un autre site ?

OXML intègre un outil qui vous permet d'afficher les vidéos de votre archive vidéos sur n'importe quel site, grâce à un simple code Javascript. Un système de template permet de personnaliser totalement l'affichage de chaque promotion.

  * Voir le fonctionnement du [[oxml/template_promo|système de template des promotions]]

Vous pouvez également réaliser une promotion spécifique pour une vidéo et l'inclure par exemple dans un blog.

===== Optimisation SEO =====

Votre site vidéo est optimisé pour le référencement auprès des moteurs de recherche.
Le nom des pages, les titres, les descriptions, les mots clés... toutes ces informations <del>peuvent</del> doivent être personnalisées.

===== Recherche et remplacement =====

Afin de disposer d'un contenu unique sur votre site, vous pouvez utiliser une liste de synonymes pour remplacer automatiquement certains mots dans les titres et descriptions des vidéos. L'outil de recherche / remplacement se trouve dans l'onglet "SEO".

De plus, vous pouvez utiliser cet outil pour mettre en valeur certains mots avec les balises HTML suivantes : <b>, <strong>, <i>, <u>, <s>

Vous pouvez par exemple utiliser : femme|<b>femme</b>

<note important>**Les mots indiqués sont sensibles à la casse et aux espaces !**

Si vous souhaitez par exemple remplacer uniquement un mot, vous pouvez indiquer " cul | <b>cul</b> "</note>


===== Utilisateurs avancés =====

  * [[oxml/tables_mysql|Contenu des tables MySQL]]

===== Addons =====

  * [[oxml/addons/sitemap|Générer un sitemap]]
  * [[oxml/addons/search_highlight|Mettre en sur-brillance un mot recherché]]
  * [[oxml/addons/last_search|Afficher les dernières recherches]]
  * [[oxml/addons/top_search|Afficher le TOP des recherches]]
  * [[oxml/addons/tag_cloud|Afficher un nuage de mots clés (tag cloud)]]
  * [[oxml/addons/moteur_recherche|Intégrer un moteur de recherche]]
  * [[oxml/addons/tri|Intégrer nombre de vidéos par pages et méthode de tri]]

===== Problèmes fréquents =====

>>> Je rencontre le message d'erreur suivant en bas de mes pages : Fatal error: Call to undefined function: file_put_contents() in .../x.php on line xxx

> Ce problème peut être rencontré lorsque vous utilisez PHP 4 sur votre hébergement. Ce bug a déjà été corrigé, vous devez donc télécharger à nouveau le script OXML depuis notre site et remplacer votre fichier "data/function.inc.php" par le nouveau présent dans l'archive téléchargé précédemment.

>>> J'ai le message "Zend Optimizer not installed" lorsque j'accède au fichier oxml.php

> Vérifier que [[http://www.zend.com|Zend Optimiser]] est correctement installé sur votre hébergement

>>> Je rencontre le message d'erreur : Fatal error: Unable to read XX bytes in /home/... on line 0

> Vous devez supprimer le(s) fichier(s) et transférer à nouveau les fichiers en **mode Binaire**

>>> Je rencontre une Erreur 500 – Erreur interne du serveur

> Le problème vient très certainement d'une erreur de configuration au niveau du fichier .htaccess généré par OXML. Renommez ce fichier en htaccess.txt et analysez ce dernier afin de trouver le problème.

===== Forum & assistance =====

Si vous rencontrez un problème ou un bug, vous pouvez obtenir de l'aide supplémentaire :
  * via notre [[http://www.multi-mb.com/forum|forum]]
  * en nous contactant directement par e-mail à l'adresse [[contact@oxphp.com]]