Communauté Francophone des Utilisateurs de Xoops

Deux extensions "Xoops" pour Google Chrome et Chromium

Thu, 19 Jan 2012 18:56:16 +0200

Vous faites peut-être parti des millions d'utilisateurs qui ont abandonné Firefox pour Google Chrome, et vous souhaitez retrouver vos extensions favorites dans celui-ci.

Le Laboratoire XooFoo.org, dans le cadre de ses actions de promotion du système de gestion de contenu Web "XOOPS", vient de créer deux extensions pour Google Chrome, l'une est similaire à la XooFooBar conçu pour Firefox, avec des liens vers les principaux sites de supports pour Xoops, les pages et groupes sur Facebook, sur Twitter, de partenaires, ainsi que les liens pertinents vers des sites d'Outils ou d'Astuces, .... ; la seconde vous permettra d'effectuer facilement des recherches sur les principaux sites de support Xoops, et principalement : FrXoops.org, Labs.XooFoo.org, TV.XooFoo.org, Xoops Project et Xuups.com.

Héritage de la class xoopsForm

Wed, 18 Jan 2012 23:30:00 +0200

Héritage de la class xoopsForm

Qu'est ce que l'héritage ?

L'héritage est un principe propre à la programmation orientée objet (POO), permettant de créer une nouvelle classe à partir d'une classe existante. La nouvelle classe "hérite" des propriétés et méthodes de la classe dont elle hérite, appelée classe "mère". La classe qui hérite est appelée classe "fille".

Cette définition est très succincte vous pouvez compléter vos connaissances en programmation orienté objet sur le web, un petit lien concernant l'héritage : http://wind.developpez.com/tutoriels/windev/windev-poo-heritage/

Xoops et l'héritage

Comme tout bon projet informatique, xoops utilise la POO. En effet ses développeurs (que je remercie au passage) ont écrit un ensemble de classes qui régissent ce projet.
Donc nous pouvons utiliser l'héritage pour ajouter, modifier le comportement de XOOPS.

Tout ça, c'est très bien, mais pourquoi faire ?

on peut modifier n'importe quelles classes directement dans le projet.

Ces modifications sont appelées des "HACKs".

C'est a ce moment précis, que vous introduisez dans votre code le grain de sable qui risque de vous miner la vie, pour l'évolution et la maintenance de votre site.
- Que vas t'il se passer à la prochaine mise à jour ? Dans 1 an.......
Plus rien ne vas fonctionner correctement, il va falloir recommencer toutes les modifica-tions une par une; Comme vous êtes un développeur compétent vous avez pris soin de consigner dans un fichier ou sur un "petit cahier" toutes les modifications à faire.

Dans le cas contraire : je vous souhaite bon courage !

L'autre solution c'est d'utiliser l'héritage, allons y !

Prenons un exemple avec un formulaire dans XOOPS.
Les formulaires dans XOOPS, bien que souvent suffisants, ne peuvent pas répondent à l'ensemble de vos besoins spécifiques.

Nous allons ici, voir 2 applications de l'héritage avec XOOPS et plus précisément avec les éléments xoopsThemeForm et xoopsElement , ce n'est que des exemples et absolument pas restrictif.

changer l'url de action du formulaire à la volé
ajouter un nouvel élément, pas disponible dans le projet initial

Nous partons du principe, que nous avons un module appelé myModule et que ce module tout à fait standard contient un répertoire class dans lequel nous allons pouvoir placer nos nouvelles classes.

La première chose, c'est comprendre comment sont hiérarchisées les classes qui génèrent le formulaire.

La classe XoopsForm est la classe de base du formulaire, c'est une classe abstraite, ce qui signifie que cette classe ne doit pas être utilisée directement mais qu'elle doit être étendue, généralisée. C'est en faite une sorte de gabarit, des propriétés et des méthodes.
Je vous laisse vous plonger dans la POO pour plus de détail.

La classe XoopsThemeForm est la classe qui généralise XoopSForm et qui vas afficher le formulaire sous forme de table, c'est cette classe dont nous hériterons, pour modifier le comportement général du formulaire.

Note : si nous voulons que notre formulaire ne s’affiche plus sous forme de tableau, alors il nous suffirait de partir directement de XoopsForm et refaire le travail à notre sauce; Pour ça, s'en se prendre la tête, il suffit de partir de xoopsThemeForm et de modifié la méthode render() qui est responsable de l'affichage.

Comme vous l'aurez remarqué, dans XoopsForm (voir API) la méthode render() est vide, et oui ! C'est ça une classe abstraite; Elle nous dit juste que cette méthode doit être redé-finie dans la classe qui l'étend.

Donc dans XoopsThemeForm la méthode est redéfinie pour affiché un formulaire sous forme de table :


function render()

    {

        $ele_name = $this->getName();

        $ret = '<form name="' . $ele_name . '" id="' . $ele_name . '" action="' . $this->getAction() . '" method="' . $this->getMethod() . '" onsubmit="return xoopsFormValidate_' . $ele_name . '();"' . $this->getExtra() . '>

            <table width="100%" class="outer" cellspacing="1">

            <tr><th colspan="2">' . $this->getTitle() . '</th></tr>

        ';

        $hidden = '';

        $class = 'even';

        foreach ($this->getElements() as $ele) {

            if (!is_object($ele)) {

                $ret .= $ele;

            } else if (!$ele->isHidden()) {

                if (!$ele->getNocolspan()) {

                    $ret .= '<tr valign="top" align="left"><td class="head">';

                    if (($caption = $ele->getCaption()) != '') {

                        $ret .= '<div class="xoops-form-element-caption' . ($ele->isRequired() ? '-required' : '') . '">';

                        $ret .= '<span class="caption-text">' . $caption . '</span>';

                        $ret .= '<span class="caption-marker">*</span>';

                        $ret .= '</div>';

                    }

                    if (($desc = $ele->getDescription()) != '') {

                        $ret .= '<div class="xoops-form-element-help">' . $desc . '</div>';

                    }

                    $ret .= '</td><td class="' . $class . '">' . $ele->render() . '</td></tr>' . NWLINE;

                } else {

                    $ret .= '<tr valign="top" align="left"><td class="head" colspan="2">';

                    if (($caption = $ele->getCaption()) != '') {

                        $ret .= '<div class="xoops-form-element-caption' . ($ele->isRequired() ? '-required' : '') . '">';

                        $ret .= '<span class="caption-text">' . $caption . '</span>';

                        $ret .= '<span class="caption-marker">*</span>';

                        $ret .= '</div>';

                    }

                    $ret .= '</td></tr><tr valign="top" align="left"><td class="' . $class . '" cols-pan="2">' . $ele->render() . '</td></tr>';

                }

            } else {

                $hidden .= $ele->render();

            }

        }

        $ret .= '</table>' . NWLINE . ' ' . $hidden . '</form>' . NWLINE;

        $ret .= $this->renderValidationJS(true);

        return $ret;

    }

Mise en pratique

Dans notre premier exemple nous souhaitons envoyer notre formulaire à un traitement différent en fonction d'une action utilisateur.

Notre formulaire est le suivant :


// Création de l'objet formulaire

$my_form = new ThemeForm("mon formulaire", 'Form_bien', "han-dle_bien.php?action=save");



// Création des éléments de formulaire

$reference = new XoopsFormText("Référence", "reference", 50, 100);



$prix= new XoopsFormText("Prix","prix",50,100);



// Ajout des éléments au formulaire

$my_form->addElement($reference,true);

$my_form->addElement($prix, true);



// Idem pour un bouton

$button = new XoopsFormButton('', 'post', _SEND, 'submit');

$my_form->addElement($button);

// Affichage du formulaire

$my_form->display();

Jusqu'ici rien de bien sorcier ! Nous allons donc modifier le comportement de XoopsThemeForm pour cela,nous créons un fichier php dans le répertoire class, que nous nommons de manière très original : my_form.php

Nous obtenons maintenant la séquence d’héritage suivante :

Pour que cette classe hérite de XoopsThemeForm, on dit aussi pour qu'elle étend, ou en-core qu'elle généralise, on écrit en php :


<?php

class MyForm extends XoopsThemeForm{



}

?>

Bien sûr pour que cela fonctionne, il faut que la classe "fille" trouve sa classe "mère", donc il faut inclure la classe XoopsThemeForm ce qui donne :


<?php

include_once(./../XoopsThemeForm.php)



class MyForm extends XoopsThemeForm{



}

?>

Vous pouvez aussi utiliser xoops_load de la manière suivante :


<?php



defined('XOOPS_ROOT_PATH') or die('Restricted access');



xoops_load('XoopsThemeForm');



class MyForm extends XoopsThemeForm {}

Ensuite on peut soit ajouter de nouvelles propriétés ou de nouvelles méthodes ou bien redéfinir des méthodes existantes, on dit dans ce cas "Que l'on surcharge (override) la méthode".

Nous allons ajouter à notre formulaire une nouvelle méthode, actuellement la classe XoopsThemeForm ne permet pas de changer le paramètre action du formulaire après avoir déclaré le constructeur, ce paramètre est passé au constructeur une fois pour toute; Mais on veut le modifier en fonction des actions utilisateurs et diriger le formulaire vers des traitement différents.

Nous allons donc ajouter une méthode :


<?php

xoops_load('XoopsThemeForm');



class MyForm extends XoopsThemeForm {



    private $newAction;



     public function setNewAction($url=null){

        

        $url===null?$this->newAction=$this->getAction():  $this->newAction=$action;

  

        }

}

?>

Cette nouvelle méthode (appelé aussi "setter") affecte l'url a la nouvelle propriété $newAc-tion si le paramètre de la fonction est passé.

Note importante :
La classe xoopsForm, n'a pas était optimisée pour être généralisée de manière a donner a ux développeurs la possibilité de faire ce qu'ils veulent, à mon grand regret. Pour cela il aurait fallu que les propriétés de la classe xoopsForm soit "protected" et non "private" (je vous renvois à la POO) ou alors que : chaque propriété soit associée à un "setter" et à un "getter". j'ignore les raisons de cette absence.
Ceci vas nous obliger a redéfinir la fonction render(). Ceux qui n'aurait pas été obligatoire si nous avions eu des "setter" ou que les propriétés eût étées "protected"

La classe avec la fonction render() redéfinie, on remplace $this->getAction par notre nouvelle propriété $newAction, ce qui donne :


<?php

xoops_load('XoopsThemeForm');



class MyForm extends XoopsThemeForm {



    private $newAction;



     public function setNewAction($url=null){

        

            $url===null?$this->newAction=$this->getAction():  $this->newAction=$action;

  

        }



    function render()

    {

        $ele_name = $this->getName();

        $ret = '<form name="' . $ele_name . '" id="' . $ele_name . '" action="' . $this->newAction. '" method="' . $this->getMethod() . '" onsubmit="return xoopsFormValidate_' . $ele_name . '();"' . $this->getExtra() . '>

            <table width="100%" class="outer" cellspacing="1">

            <tr><th colspan="2">' . $this->getTitle() . '</th></tr>

        ';

        $hidden = '';

        $class = 'even';

        foreach ($this->getElements() as $ele) {

            if (!is_object($ele)) {

                $ret .= $ele;

            } else if (!$ele->isHidden()) {

                if (!$ele->getNocolspan()) {

                    $ret .= '<tr valign="top" align="left"><td class="head">';

                    if (($caption = $ele->getCaption()) != '') {

                        $ret .= '<div class="xoops-form-element-caption' . ($ele->isRequired() ? '-required' : '') . '">';

                        $ret .= '<span class="caption-text">' . $caption . '</span>';

                        $ret .= '<span class="caption-marker">*</span>';

                        $ret .= '</div>';

                    }

                    if (($desc = $ele->getDescription()) != '') {

                        $ret .= '<div class="xoops-form-element-help">' . $desc . '</div>';

                    }

                    $ret .= '</td><td class="' . $class . '">' . $ele->render() . '</td></tr>' . NWLINE;

                } else {

                    $ret .= '<tr valign="top" align="left"><td class="head" colspan="2">';

                    if (($caption = $ele->getCaption()) != '') {

                        $ret .= '<div class="xoops-form-element-caption' . ($ele->isRequired() ? '-required' : '') . '">';

                        $ret .= '<span class="caption-text">' . $caption . '</span>';

                        $ret .= '<span class="caption-marker">*</span>';

                        $ret .= '</div>';

                    }

                    $ret .= '</td></tr><tr valign="top" align="left"><td class="' . $class . '" cols-pan="2">' . $ele->render() . '</td></tr>';

                }

            } else {

                $hidden .= $ele->render();

            }

        }

        $ret .= '</table>' . NWLINE . ' ' . $hidden . '</form>' . NWLINE;

        $ret .= $this->renderValidationJS(true);

        return $ret;

    }



}

?>

Maintenant nous pouvons l'utiliser de la manière suivante :


$my_form=new MyForm(paramètres);



If(condition){

// maintenant on change l'url du formulaire

   $MyForm->setNewAction('test.php')

}

Vous pouvez faire une mise à jour s'en risque......

Deuxième exemple on souhaite ajouter un élément qui n'existe pas dans les classes de XOOPS, par exemple on veut que notre formulaire affiche des images précédemment téléchargées sur le serveur, pour informer l'utilisateur.

Il n'y a pas d'élément, affiche image, dans les formulaires de XOOPS. Nous allons donc le créer en étendant la classe XoopsFormElement, qui est la classe chargée de créer un élément de formulaire, comme formcolorpicker etc....

ce qui donne comme héritage :

classe :


<?php



defined('XOOPS_ROOT_PATH') or die('Restricted access');



class MyElement extends XoopsFormElement

{

    

    var $_content;

    

    function __construct($caption = '', $value = '', $name = '')

    {

        $this->setCaption($caption);

        $this->setName($name);

        $this->_value = $value;

    }

    

    function setContent($content)

    {

        $this->_content=$content;

        

    }

    

    function getContent($encode=false){

        

        return $encode ? htmlspecialchars($this->_content, ENT_QUOTES) : $this->_content;

        

    }

    

    function render()

    {

        return $this->getContent();

    }

}

?>

La méthode fonction setContent($content) vas nous permettre d’insérer du contenu.

Utilisation :


$planchePhoto=new myElement();

$planchePhoto->setContent('<div class="photos">vos photos</div>');

Maintenant que nous avons créer un nouvel élément de formulaire , ajoutons le à notre formulaire


$my_form->addElement($planchePhoto);

Voilà nous avons ajouté un élément à notre formulaire

TDMmoney 1.1

Thu, 12 Jan 2012 20:42:28 +0200

L'équipe de FreeXoopServices est heureuse de vous annoncer la sortie de TDMmoney 1.1.

Liste des bugs corrigés :

Bug avec les redirections (Mage)
Il était impossible de modifier une opération dans l'administration (Mage)
Les caractères UTF-8 ne s'affichaient pas correctement dans le PDF (Mage).

Liste des améliorations:

La partie administration à été recodée (compatible à 100% avec xoops 2.5) (Mage)

Informations

Voir le fichier "lang_diff.txt" pour les changements de langues..

Installation:

Vous devez effacer le dossier "TDMMoney qui se trouve dans "modules".
Uploader le dossier "TDMMoney" sur votre serveur dans le dossier "modules"
Faire une mise à jour du module.

Important

Le module nécessite l'utilisation du Frameworks "ModuleClasses" pour fonctionner.
Le module travail uniquement sur xoops 2.5x

Téléchargement

TDMmoney 1.1 et sa traduction française

APCal mis à jour à la version 2.0.3

Thu, 12 Jan 2012 20:36:00 +0200

APCal version 2.0.3 est maintenant disponible sur http://xoops.antiquepromotion.com

La traduction espagnol est maintenant complète.

Nous avons également amélioré la boîte descriptive dans la vue mensuelle afin qu'elle ne dépasse pas les limites de la fenêtre du navigateur.
De plus, nous avons corrigé a petit bug lors de l'insertion d'un évènement.

Joyeuse Année 2012 !

Sat, 31 Dec 2011 13:06:21 +0200

Trois nouveaux thèmes gratuit pour Xoops

Fri, 30 Dec 2011 11:19:18 +0200

Xoops Demo vous présente 3 nouveaux thèmes GRATUIT et adapté pour Xoops : XDGrey, XDClassified et XDBlack_wall.
Ces thèmes se composent de 3 colonnes et sont compatibles avec Internet explorer, Firefox, Safari, Chrome et Opera.

XDGrey est basé sur le thème défaut et du template templatemo_162_gray_company.

Téléchargement : à cette adresse et en action : sur ce site.

XDClassified est basé sur le thème défaut et du template Classified

Téléchargement : à cette adresse et en action : sur ce site

XDBlack_wall est basé sur le thème défaut et du template templatemo_335_black_wall.

Téléchargement : à cette adresse, et en action : sur ce site.

XDTazer : Template GRATUIT pour Xoops

Fri, 09 Dec 2011 01:14:04 +0200

Xoops demo vous présente l'adaptation d'un nouveau thème pour Xoops nommé XDTazer

Voici un nouveau template Réalisé avec le gabarit default et le PSD de myjilson.Il dispose de 2 colonnes (une à gauche ou a droite ).

Vous pouvez utiliser ce thème avec xoops 2.4.5 et 2.5.x

Visible ici

Téléchargeable ici

APCal v2.0.2 Final - Calendrier avec carte pour XOOPS 2.4 / 2.5

Fri, 09 Dec 2011 01:10:49 +0200

APCal est un module vous permettant d'afficher un calendrier d'événements avec une carte sur votre site web. Plusieurs autres caractéristiques ont été ajoutés, optionnelles pour la plupart. Ce module est basé sur PiCal.

Ce module va copier vos données de PiCal pour une transition simple.

Cette version est un grand pas en avant depuis la version 1.

Visiter http://xoops.antiquepromotion.com pour le télécharger !

NOUVELLES CARACTÉRISTIQUES :

Événements sur une ligne (au lieu de le répéter chaque jour) dans la vue mensuelle.
Images miniatures et visualisateur dans la vue événementielle.
Nouveaux champs pour le courriel et le site web.
Chaque catégorie possède une couleur.
Légende des catégories avec couleurs associées.
Couleurs par défaut plus neutre pour une meilleure intégration.
Réorganisation de l'interface administrateur.
Bouton "parlez-en à un ami".
Boutons de partage sur les principaux réseaux sociaux (Facebook, Twiter, Google+, LinkedIn, Delicious).
Option : Ajouter des photos à un événement avec une image principale.
Option : Choisir une catégorie principale pour chaque événement.
Option : Choisir des heures différentes pour chaque jour d'un événement (s'il est sur plusieurs jours).

Veuillez reporter tout problèmes rapidement sur xoops.antiquepromotion.com ou ici.
Nous allons essayer d'avoir une version RC d'ici une semaine.

Caractéristiques originales :

Marqueurs contenant la date de l'événement sur la carte.
Optimisé pour Google (titre et description).
Possibilité d'ajouter une description en HTML pour chaque catégorie.
Amélioration de la personnalisation du thème.
Option : Carte affichant tous les événements.
Option : Carte affichant l'emplacement de l'événement spécifié.
Option : Afficher le titre de la catégorie en H1.
Option : API qui permet à vos utilisateurs d'afficher votre calendrier sur leur site (Avec un lien vers votre site).
Option : Menu de navigation permettant de naviguer à travers les événements.
Option : Colonnes plus larges pour les jours spécifiés.
Option : Calendrier perpétuel des fêtes nationales (Uniquement pour les États-Unis (EN), le Canada (EN), le Québec (FR) et la France (FR).
Option : Réécriture d'URL (si le serveur le permet).
4 vues différentes (Journalière, hebdomadaire, mensuelle et annuelle).
Les utilisateurs peuvent ajouter des événements si les permissions le permettent.
Exportation et importation au format ICS.

Un site de petites annonces pour les disques vinyles !

Wed, 30 Nov 2011 23:03:26 +0200

Bonjour,

Je vous présente ma toute dernière création réalisé sous Xoops.

Un site de petites annonces de Disques Vinyles.

Xoops 2.5.4 est publié en version finale

Mon, 21 Nov 2011 00:34:36 +0200

XOOPS 2.5.4 Final

Article original par Mamba du 20/11/2011 sur Xoops.org et librement adapté par l'équipe FrXoops

Nouveautés

L'équipe de développement XOOPS est heureuse d'annoncer la sortie de XOOPS 2.5.4 Final.

Mise à jour de nos bibliothèques :
- phpMailer 5.1
- TinyMCE 3.4.6 (nota: TinyMCE 3.4.7 dans la version française)
- jQuery 1.7.0
- jQueryUI 1.8.16
Mise à jour des modules livrés avec le noyau Xoops, qui recourent désormais au Framework Module Admin et disposent donc d'une interface d'administration standardisée :
- Private Message
- Profile
- Protector
Bugs principaux corrigés (pour plus de détails, lisez le changelog) :
- quoteConv causait des problèmes avec un nombre important de quotes (Roby73/trabis)
- Cache bug. La clé n'était générée correctement (andrey3761/trabis)
- ID: 3425970 Inconnu : Function split() (cesag/trabis)
- ID: 3424295 Index non défini : tplset (cesag/trabis)
- Préférences n'utilisait correctement le champ de description, tooltip n'affichait pas le titre et la description sans espace (trabis)
- Extra height in admin page when warnings are not displayed (timgno/trabis)
- Files loaded with browse.php (*.js, *.css, etc) are not cached by the browser (trabis)
- ID: 3421180 CBB 4.05 et Xoops 2.5.4 - erreur avec le with Framework (cesag/trabis)
- Retrait de l'appel à une feuille de style inexistante dans le menu d'administration
- ID: 3419812 glisser déposer et Xoops 2.5.3 (CESAG / Trabis)
- Élément de formulaire Calendrier ne fonctionne pas correctement (Trabis)
- Vérification /xoops_data accessible en écriture lors de l'installation (Trabis)
- ID: 3419332 Déconnexion bug (Cesag / Trabis)