Blog notes Aternatik

Exemple d'utilisation d'un pipeline SPIP

Aternatik — 2010-08-21T09:00:27Z

Une brève procédure pour expliquer l'utilisation d'un pipeline SPIP. Un pipeline est une fonctionnalité du le gestionnaire de contenu SPIP. Ce système de points d'entrée permet d'ajouter des traitements (calcul, affichage d'infos spécifiques, etc...) à SPIP sans modifier une seule ligne de code au coeur de l'application.

Un rédacteur a besoin de connaitre le nombre de caractères du texte d'un article avant de le publier. Ce calcul et l'affichage n'étant pas prévu par SPIP dans sa version officielle, il va falloir mettre les mains dans le camboui

On pourrait directement trouver la page concernée dans l'espace privé et la modifier dans le code de SPIP. Seulement, ces modifications risquent d'être écrasées lors d'une mise à jour du logiciel. Pour éviter cela, SPIP offre aux développeurs un mécanisme qui permet de surcharger les fonctions existantes ou en ajouter d'autres plus spécifiques.

Comme indiqué précisément, le système des pipeline va être utilisé. Le pipeline "affiche_milieu" convient parfaitement pour ajouter une information dans les pages d'affichage des articles dans l'espace privé (le back office du site).

Appel du pipeline

Les "pipeline" sont en général utilisés par un plugin dans lequel le fichier de configuration "plugin.xml" permet de les déclarer. Ici, une autre méthode est utilisée : l'utilisation du fichier "mes_fonctions.php" à placer dans le répertoire config du site.

Déclaration du pipeline :

$GLOBALS['spip_pipeline']['affiche_milieu'] .= "|nombre_caracteres_article";

On voit que la déclaration du pipeline s'effectue en modifiant un tableau $GLOBALS['spip_pipeline'] qui est géré par SPIP. La chaine |nombre_caracteres_article indique qu'on va envoyer le flux qui contient les données à la fonction nombre_caracteres_article.

Fonction de traitement

Il faut maintenant créer la fonction qui va exécuter le traitement. Voici le code, à placer également dans le fichier config/mes_options.php :

function nombre_caracteres_article($flux){
// La fonction s'exécute si on est sur l'url ecrire/?exec=articles&id_article=XXX
$exec = $flux["args"]["exec"];
if ($flux['args']['exec'] == "articles") {

$id_article = $flux["args"]["id_article"];
// Récupère le texte de l'article et le nettoie
$texte = attribut_html(sql_getfetsel('texte', 'spip_articles',"id_article=$id_article"));
// Compte le nombre de caractères dans la chaine
$nb_car = strlen($texte);
// le code html à retourner
$ret = '

Longueur du texte : '.$nb_car.' caractères.

';
$flux["data"] .= $ret;
}
return $flux;
}

Télécharger

Sauvegarder le fichier et vider le cache du site. La longueur du texte de l'article s'affiche maintenant sur les pages articles dans l'espace privé

Voir en ligne : Liste des pipelines SPIP

Simuler des liens avec jQuery (et SPIP)

Aternatik — 2010-08-05T14:37:43Z

Simuler des liens sans multiplier les balises "a" dans le code source des documents html.

En terme d'accessibilité de référencement, il est recommandé de n'attribuer qu'un seul lien par ressource (une page, un document...) dans le code source d'un document html.

Or pour tenir compte des habitudes des utilisateurs, il est souvent nécessaire d'avoir plusieurs zones cliquables, renvoyant vers la même ressource.

La librairie jQuery va nous servir à simuler des liens sur des éléments de la page : titre de l'article, description complète, etc...

Le script est particulièrement adapté pour que les évènements javascript soient gérés correctement avec le mécanisme de pagination ajax particulière au cms SPIP.

Code html

Tout d'abord le contenu : une liste d'articles (squelette SPIP) :

(ARTICLES)

{id_article}

{statut?}

[#URL_ARTICLE" title="Lire [(#TITRE|strtolower)]" class="highlight">(#LOGO_ARTICLE_RUBRIQUE||image_reduire{150})]

#TITRE

[
(#INTRODUCTION{100})
]

Télécharger

L'unique lien est sur l'image dans le code html, et une classe "link" est appliquée au titre "h3".

Javascript

Le code javascript nécessaire pour déclencher le lien lors du click sur un objet avec la classe "lien" :

Télécharger

En cliquant sur le titre, la page se recharge et affiche la cible. Seulement en apparence, rien ne montre à l'utilisateur qu'un lien est disponible. Toujours en javascript, il faut styler les élement et prendre en compte le survol avec la fonction hover. Le code final du fichier fonction.js à inclure dans les entêtes des pages :

/* Simulation d'un lien avec jquery */
function link_init(){jQuery(function(){
jQuery('.link').click(function(){

var link = $(this).parent().find('a').attr('href');
window.location.href=link;
});
jQuery('.link').hover(
function(){
jQuery(this).css("cursor","pointer").css("text-decoration","underline");
},
function(){
jQuery(this).css("cursor","normal").css("text-decoration","none");
}
);
});}
jQuery(function(){link_init.apply(document); onAjaxLoad(link_init);});

Télécharger

Ce code est bien sûr à adapter selon les besoins et la structure de la page, notamment en ce qui concerne la recherche de l'attribut "href" qui contient l'url cible.

onAjaxLoad est une fonction spécifique à SPIP. Sans elle, les évènements ne fonctionneront pas lors de l'utilisation du mécanisme des blocs ajax (pagination ou autre).

Plugin SPIP d'extraction de mot clés

Aternatik — 2010-06-26T17:13:33Z

Une fonction qui extrait des mots clés d'une chaine de caractères (comme le texte d'un article) mis en plugin SPIP pour faciliter sa configuration et sa réutilisation.

Fonctionnement et utilisation

Après installation et activation, ce plugin met à disposition le filtre |extraire_motcles pour extraire les mots d'une chaine de caractères en fonction de leur occurrence.

La première utilisation de cette fonction est la génération automatique de la balise meta "keywords" en fonction du texte d'un article :

(ARTICLES) {id_article}>
[(#TITRE|textebrut) - ][(#NOM_SITE_SPIP|textebrut)]
[(#INTRODUCTION{180}|textebrut)" />]
[(#TEXTE|attribut_html|extraire_motcles)" />]
[(#URL_ARTICLE|url_absolue)" />]
>

Télécharger

Par défaut, une chaine comprenant les mots clés séparé par une virgule est retournée par la fonction. Si la fonction est utilisé dans un script PHP, on peut avoir besoin d'un tableau. Dans ce cas, utiliser l'appel suivant :

$mots = extraire_motcles($chaine,"tableau");

Configuration

Un page de configuration permet de régler les variables de la fonction :

le nombre de caractères minimum d'un mot
le nombre d'occurrence d'un mot dans la chaine
le nombre de mot total retourné
les mots à exclure

Extraire les mots récurrents dans une chaine composé des textes des articles d'une rubrique :

Télécharger

Une passerelle Thelia -> Dolibarr en module

Aternatik — 2010-02-08T11:11:00Z

Thelia est un logiciel e-commerce open source et Dolibarr est un logiciel de gestion d'entreprise lui aussi open source. Intégrés conjointement dans un même système d'information, vous obtenez une solution ecommerce performante (Thelia) et riche en fonctionnalités de gestion d'entreprise (Dolibarr).

Fonctionnement du module

Un webservice (installé sur le site Thelia) est interrogé à partir de Dolibarr. Les éléments Thelia peuvent être importés : clients, produits, catégories et commandes.

Dans la base de données Dolibarr, des tables sont utilisées pour faire la relation entre les objets des deux logiciels (ex : fiche client Thelia et fiche client Dolibarr).

Fonctionnalités manquantes

Le module ne fonctionne pas encore en écriture dans la base de données Thelia. On pourra faire appel aux triggers Dolibarr pour par exemple effectuer la mise à jour de la base Thelia en cas de mise d'un produit.

La gestion des permissions au sein du module n'est pas développée.

Tester le module

Le module est encore en développement mais néanmoins fonctionnel (ou presque). Vous pouvez tester ce module en téléchargeant les sources ci-dessous.

Merci de votre retour, soit en commentaires en bas de cette page soit par mail.

Contribuer au module

Toute contribution est bienvenue sous forme de patch (comment faire un patch ?), àenvoyer ici.

Ces modifications seront intégrées dans Dolibarr pour les prochaines versions. Vous pouvez également vous inscrire sur le dolibarr.pro pour contribuer au projet.

Rester informé

Mise à jour

La société Octolys qui développe le logiciel ecommerce THELIA a repris le développement de ce module. Pour plus d'infos sur la version bêta, consultez le blog Thelia

Le développement de ce module est basé sur le module OSCommerce WS déjà existant dans Dolibarr.

Ressources pour développer Dolibarr

Aternatik — 2009-12-30T00:02:42Z

Déstinée aux développeurs, cette liste donne des pointeurs à connaitre pour tout développement sur le logiciel Dolibarr.

Liens officiels

Le wiki dolibarr est la plus importante base de connaissance sur le développement d'un module. Voici quelques liens à consulter :

Une question trouve souvent une réponse dans le forum (francophone / anglophone)

Fichiers utiles :

fonctions usuelles (pour la manipulation de dates, images d'actions, prix, tva, etc...) : htdocs/lib/functions_functions_lib.php

Dolibarr 2.7 prévue pour le 30 novembre

Aternatik — 2009-11-18T16:54:12Z

Au menu des nouveautés : le module import de données et le module caisse enregistreuse.

Rappelons que Dolibarr est un logiciel modulaire (on n'active que les fonctions que l'on désire) de gestion d'entreprises, d'indépendants ou d'associations. C'est un projet OpenSource basé sur un serveur WAMP ou LAMP (Apache, Mysql, PHP). Dolibarr se démarque des offres de logiciels de cette catégorie comme OpenAguila, OpenBravo, OpenERP (Ex TinyERP), Neogia, Compiere, Adempiere, etc par le fait qu'ici tout est fait pour offrir de la simplicité :

Simple pour l'installation (avec un installeur DoliWamp pour Windows ou Mac, pour ceux qui ignorent comment installer un serveur Apache, Mysql, PHP, un assistant Web pour les autres, aucun composant complémentaire, ni Java, ni Python, ni Perl, ni module PHP PEARL, ni autre librairie exotique).
Simple pour l'utilisation (tout module est débrayable pour alléger au maximum les menus, seul le mécanisme des habilitations ne l'est pas).
Simple pour le développement (pas de frameworks lourds). Dolibarr, développé en PHP objet, intègre en effet ses propres classes permettant à tout développeur d'être tout de suite opérationnel sans connaissances particulières autre que le PHP).

Il vise donc une cible différente, que sont les PME/TPE, indépendants, professions libérales, micro-entreprises ou associations, la où la sophistication des autres produits les rend plus adaptés aux plus grosses structures.

L'ensemble des fonctionnalités couvertes par cette version sont décrites sur le site Web : http://www.dolibarr.fr/fonctionnalites/

Modifications par rapport à la version 2.6 :

La liste n'est disponible qu'en anglais :

For users :

New : Add a print icon to show a page to print without menus.
New : Can add a free text on bank cheque receipts.
New : Price level can be defined also for prospects.
New : Add a help and support center.
New : Can export commercial proposals.
New : Can use a cache for xcal exports.
New : Option for faster confirmation process with one ajax popup.
New : Complete theme bluelagoon and rodolphe
New : Can select third parties emails in emailing module for all third parties with expired contract's lines.
New : Can add a field errors-to in emailing.
New : Can use inline images in emails.
New : Add predefined invoices (can be use for repeated invoices).
New : Add a confirmation when cloning products.
New : Add stock in product lists.
New : Can filter list of stock movement on date or product.
New : Added a link from product list to their stock movements.
New : Several speed enhancements after using the Google Page speed plugin for FireBug.
New : Add a confirmation on dangerous admin purge feature.
New : Add navigation on donation sheets.
New : Added estimated value for stocks.
New : Added module Gravatar to found photo of users or members from their email on gravatar.com.
New : Include Dolibarr version in suggested dump filename.
New : Enhancement in project module.
New : Add log tab on emailing module.
New : Minor enhancements in look themes.
New : Add option to hide help in menu.
New : Added a "force LDAP synchronize" on member and contact cards.
New : Can split a discount into two smaller discount. This allows to use a discount on an invoice even if invoice amount is lower than discount credit available.
New : Can use variables into the free text on PDF (__TOTAL_TTC_, __TOTAL_VAT...)
New : Increase page loading speed (all changes reported by Google PageSpeed tool has been added).
New : Add support of constant MAIN_ONLY_LOGIN_ALLOWED to allow to lock all access to any users except the one defined in constant.
New : Add an admin page of PHP sessions with a way to lock new connections for other users than yourself. Can also purge existing sessions.
New : Add point of sale module.
New : Better usage when using with smartphones.
New : Add module FTP client.
New : Can set first day of week.
New : Installer now create a .htaccess to protect documents directory.
New : Experimental support for Postgresql.
Fix : "Now" link works when date popup is not used.
Fix : Debug seriously the email notification module.
Fix : Error Call to a member function trans when refusing a supplier order.
Fix : Fix payment conditions on commercial proposals.
Fix : Nb of orders to process was wrong.
Fix : Customer code was not correct on PDF it if contains special characters.
Fix : Can update price even with "NPR" VAT rates.
Fix : When product type is missing, description is not lost when adding new product lines.
Fix : CC and BCC in emails was not used if using SMTPS handler.
Fix : Last character was lost when text end with n or r.
Fix : LDAP synchronization is now more robust (transaction and use modify instead of delete/add).
Fix : Fix : Setup of member synchronization does not conflict with contact or user synchronization.

For translators :

Update some language files.
Can accept right to left languages. Added an "automatic" arabe translation.

For developers :

An external module can force the third party code to be required whatever is the rule of third party code module.
Update fckeditor to 2.6.4.
Update Smarty to 2.6.26.
Removed some deprecated code and files.
Creation of directory in module descriptor is simpler.
Can use an alternate document_root directory to develop with sources on two repositories.
Removed useless code of old commercial module.
Move some modules into the CVS modules repository dolibarrmod. This reduces amount of code in main branch.
Updated wiki documentation.
Better W3C standard.
Can add init data when enabling a module.
Can fix some corruptions in database by calling the update page /install/repair.php
Log files contains more information (PHP_SELD added and OS user used for log of command lines scripts)
Can protect a module to not being enabled if javascript disabled.
If module numberwords is installed, code can use langs->getLabelFromNumber to get value of an amount in text.
A module can add subsitution keys in makesubsitutions() functions.
Add $conf->browser->phone defined to optimise code for smartphone browsers.
All external libs are now in same directory /includes.
All install files are now in same directory /install.

Voir en ligne : Site officiel Dolibarr

Installation Asterisk sur debian

Aternatik — 2008-08-08T18:53:39Z

Asterisk est un PCBX : un serveur de communications téléphoniques qui utilise le protocole SIP. Autrement dit : un serveur voip... L'article décrit l'installation des paquets debian et la configuration minimale.

On va tout d'abord installer un vserver de test. Sur le serveur hôte :

master:/# vserver asterisk build -m debootstrap --context 1122 --hostname asterisk.test.lan --interface eth0:192.168.0.2/32 --force -- -d etch
[...]
asterisk:/# vserver asterisk start
asterisk:/# vserver asterisk enter
asterisk:/# apt-get install locales ssh vim
asterisk:/# dpkg-reconfigure locales

Télécharger

Pour éviter la compilation du logiciel Asterisk (nécessaire pour avoir la dernière version qui inclus les derniers codecs), le paquet fournit par debian va nous servir.

Avant d'installer, une recherche dans les bons paquets :

obelix:/# apt-cache search asterisk
asterisk - Open Source Private Branch Exchange (PBX)
asterisk-app-dtmftotext - Text entry application for Asterisk
asterisk-app-fax - Softfax application for Asterisk
asterisk-bristuff - Open Source Private Branch Exchange (PBX) - BRIstuff-enabled version
asterisk-chan-capi - Common ISDN API 2.0 implementation for Asterisk
asterisk-classic - Open Source Private Branch Exchange (PBX) - original Digium version
asterisk-config - config files for asterisk
asterisk-dev - development files for asterisk
asterisk-doc - documentation for asterisk
asterisk-h323 - asterisk H.323 VoIP channel
asterisk-oh323 - oh323 channel driver for Asterisk
asterisk-prompt-de - German voice prompts for the Asterisk PBX
asterisk-prompt-es-co - Colombian Spanish voice prompts for Asterisk
asterisk-prompt-fr - French voice prompts for Asterisk
asterisk-prompt-it - Italian voice prompts for the Asterisk PBX
asterisk-prompt-se - Swedish voice prompts for Asterisk
asterisk-sounds-extra - Additional sound files for the Asterisk PBX
asterisk-sounds-main - sound files for asterisk
asterisk-web-vmail - Web-based (CGI) voice mail interface for Asterisk
destar - management interface for the Asterisk PBX
iaxmodem - software modem with IAX2 connectivity
kiax - IAX VoIP softphone
libiax-dev - implementation of the Inter-Asterisk eXchange protocol (devel)
libiax0 - implementation of the Inter-Asterisk eXchange protocol
apt-get install asterisk asterisk-doc asterisk-prompt-fr asterisk-sounds-main asterisk-sounds-extra

Télécharger

Configuration

Editer le fichier /etc/default/asterisk et indiquer les bons paramètres :

RUNASTERISK=yes
RUNASTSAFE=yes

Télécharger

Mise en orbite

Après quelques petits soucis dû l'utilisation d'un vserver, Asterisk est enfin démarré et prêt à fonctionner.

obelix:/# /etc/init.d/asterisk start
Starting Asterisk PBX: asterisk.
obelix:/# Asterisk ended with exit status 0
Asterisk shutdown normally.
obelix:/# pstree
init─┬─asterisk───19*[{asterisk}]
├─cron
├─sshd
└─syslogd
obelix:/# netstat -lp
Connexions Internet actives (seulement serveurs)
Proto Recv-Q Send-Q Adresse locale Adresse distante Etat PID/Program name
tcp 0 0 obelix:5038 *:* LISTEN 8709/asterisk
tcp 0 0 obelix:sieve *:* LISTEN 8709/asterisk
tcp 0 0 obelix:ssh *:* LISTEN 8448/sshd
tcp 0 0 obelix:1720 *:* LISTEN 8709/asterisk
udp 0 0 obelix:2727 *:* 8709/asterisk
udp 0 0 obelix:4520 *:* 8709/asterisk
udp 0 0 obelix:sip *:* 8709/asterisk
udp 0 0 obelix:iax *:* 8709/asterisk
Sockets du domaine UNIX actives(seulement serveurs)
Proto RefCpt Indicatrs Type Etat I-Node PID/Program name Chemin
unix 2 [ ACC ] STREAM LISTENING 16218862 8709/asterisk /var/run/asterisk/asterisk.ctl
obelix:/#

Télécharger

Il faut maintenant créer le dialplan pour faire communiquer tous nos téléphones SIP.

Des liens

Site officiel Asterisk
Une bonne introduction pour Asterisk et la Voip : Wiki SOS Admin
Asterisk sur Wikipedia

PostfixAdmin : gérer simplement ses utilisateurs virtuels

Aternatik — 2008-07-26T14:09:04Z

Présentation d'une interface d'administration en PHP pour gérer la configuration (domaines et utilisateurs virtuels) du serveur de messagerie Postfix.

PostfixAdmin permet donc de gérer graphiquement les utilisateurs virtuels sur un sytème de messagerie. Ecrit en PHP, il utilise une base de données Mysql. Postfix est d'ailleurs configuré lui aussi pour aller chercher les informations de utilisateurss dan cette base de données.

L'installation est relativement simple. Comme toujours, il faut indiquer les bons paramètres de config aux bons endroits ^^

Utilisation / fonctionnalités

Plusieurs niveaux d'utilisation : l'administrateur du serveur, l'administrateur de domaine et utilisateur final.

En tant qu'administrateur du serveur, vous pouvez :

créer / modifier / supprimer un domaine
créer / modifier / supprimer un administrateur de domaine
créer / modifier / supprimer des alias
créer / modifier / supprimer des boites aux lettres
sauvegarder la base de données
Consulter les journaux des actions les administrateurs de chaque domaine
consulter les administrateurs de domaine le nombre de domaines
consulter tous les domaines / alias / boites aux lettres
activer / désactiver un domaine
activer / désactiver une boite au lettres

En tant qu'administrateur de domaine, vous pouvez :

créer / modifier / supprimer les alias pour un domaine
créer / modifier / supprimer les boites aux lettres d'un domaine
consulter les domaines, alias et boites aux lettres
activer / désactiver les boites aux lettres

En tant qu'utilisateur, vous pouvez :

Créer ou supprimer un répondeur (message d'absence)
gérér les redirections d'email
modifier le mot de passe de votre boite aux lettres

A noter que le message d'absence requiert vacation et nécessite une configuration plus avancée. cds

Des liens

Screencast

Aternatik — 2008-06-09T15:45:22Z

Un screencast est une capture vidéo de l'écran. C'est l'outil idéal pour montrer l'utilisation d'un logiciel. Fabrication en .ogg avec recordMyDesktop et encodage avec mencoder.

Dans un premier temps, il faut capturer l'image de l'écran. Pour cela, le logiciel recordMyDesktop est utilisé.

Il est possible de capturer le bureau soit en totalité soit uniquement une fenêtre.

Après avoir paramétré recordMyDesktop (bouton "avancé", choisissez le dossier de destination (il faut cliquer sur "enregistrer sous" AVANT de commencer la capture) et cliquer sur "enregistrer" pour démarrer la capture.

L'enregistrement est signalé par une icone dans la zone de notification (un rond rouge) Cliquer sur cet icône pour stopper la capture. Encodage

Le fichier de sortie est un fichier .ogg. Pour le convertir en .avi, utiliser mencoder (installer le paquet si nécessaire ) :

mencoder demo-screencast.ogg -ovc lavc -oac mp3lame -o demo-screencast.avi

Pour redimensionner l'image utiliser cette commande :

mencoder -idx screencast-catalogue.ogg -o screencast-catalogue.avi -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=2000:vhq -vf scale=640:480 -oac mp3lame

Pour lire les vidéos, utilisez VLC

De liens

Configurer Postfix pour un site web

Aternatik — 2008-03-07T00:04:32Z

Configuration de Postfix pour seulement envoyer des mails à partir d'un site internet (avec PHP)

*** Ceci est une note rapide, juste pour mémoire ***

On dispose déjà d'un serveur de messagerie qui fonctionne sur une autre machine.

domain.tld est le nom de domaine (à remplacer, bien évidemment...)

Voila la configuration :

mydomain = srv2.domain.tld
 myhostname = $mydomain
 # Les courriels seront envoyées à cette machine. On met notre domaine : le mx (configuré dans les DNS) ainsi sera utilisé
 relayhost = domain.tld
 # Indique l'origine des courriels : on a une machine srv2.domain.tld mais on ne veut pas que les mails soient de la forme @srv2.domain.tld 
 # Renseigner le fichier /etc/mailname
 myorigin = /etc/mailname
 
 
 mydestination = localhost
 # Interface que l'on souhaite utiliser
 inet_interfaces = __ip_machine__

Des liens :

Voir en ligne : Postfix