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

URL rewriting - Redirection des pages vers un sous domaine

Aternatik — 2007-09-18T09:52:19Z

J'ai eu à déplacer les pages d'un site principal vers un sous domaine. Les url à déplacer sont réécrites, bien référencées et je n'avait pas envie de tout perdre (et référencement, et visiteurs...). Explications et marche à suivre avec l'url rewriting pour un transfert sans bobo.

Contexte

J'ai développé un annuaire (sur la base de myphpannu ou encore categorizator) sur le domaine moto-sites.net. Seulement je souhaite migrer les pages de l'annuaire vers le sous domaine annuaire.moto-sites.net.

Les urls à déplacer sont de cette forme :

http://moto-sites.net/accessoires-du-motard-p1-37.html

http://moto-sites.net/detail-l-aspi-racing-journees-d-entrainements-moto-9.html

Il va falloir utiliser un fichier htaccess qui va contenir les règles d'écriture.

Voici le fichier qui fonctionne

#Redirection vers l'annuaire

RewriteRule ^(.*-p[0-9]*-[0-9]+\.html) http://annuaire.moto-sites.net/$1 [L,R=301]

RewriteRule ^(.*-k[0-9]*-[0-9]+\.html) http://annuaire.moto-sites.net/$1 [L,R=301]

RewriteRule ^(detail-[a-z-\-]*-[0-9]+\.html) http://annuaire.moto-sites.net/$1 [L,R=301]

RewriteRule ^(sitemap\.xml) http://annuaire.moto-sites.net/$1 [L,R=301]

RewriteRule ^(nouveautes\.php) http://annuaire.moto-sites.net/$1 [L,R=301]

$1 correspond à ce qui est mis entre parenthèses. Le reste n'est qu'une mise en forme de l'url et vous n'avez qu'à recopier vos règles existantes Vous remarquerez qu'une redirection 301 est faite pour indiquer aux moteurs de recherche que la page a été déplacées.

Sur le sous domaine, vous devez avoir un fichier htaccess qui donne les règles d'écriture du site. Cette fois c'est :

RewriteRule -p([0-9]*)-([0-9]+)\.html$ /index.php?cat_id=$2&page=$1 [L]

RewriteRule -k[0-9]*-([0-9]+)\.html$ /search.php?action=seek&mots=id$1&nb_results2show=20&booleen=AND [L]

RewriteRule ^detail-[a-z-\-]*-([0-9]+)\.html /affsite.php?site=$1 [L]

RewriteRule ^sitemap\.xml$ /allcategs.php?sitemap [L]

Je sais pas si cette technique est vraiment la bonne mais ça à l'air de fonctionner

Voir en ligne : Moto-Sites.Net

Installation d'un serveur Subversion

Aternatik — 2007-08-30T20:55:59Z

Aide mémoire pour l'installation d'un gestionnaire de version : subversion.

Pré requis

apt-get install subversion subversion-tools libapache2-svn

Créer le répertoire de dépôt pour le projet. J'ai choisi le dossier /var/svn pour stocker les projets.

svnadmin create --fs-type fsfs /var/svn/projet

Il faut configurer apache. Le dépôts sera accessible sur le serveur virtuel dev.test.lan. Un "alias" /projet renvoit vers le dossier du projet

vi /etc/apache2/sites-available/dev.test.lan
 
 
 ServerName dev.test.lan
 DocumentRoot /var/svn
 ServerAdmin root@test.lan
 
 
 AuthType Basic
 AuthName "Serveur SVN"
 AuthUserFile /var/svn/access.passwd
 require valid-user
 
 
 DAV svn
 SVNPath /var/svn/projet

Pour créer le fichier de mot de passe :

htpasswd2 -c /var/svn/access.passwd utilisateur

Installer l'hôte virtuel et redémarrer Apache :

a2ensite dev.test.lan
 /etc/init.d/apache2 reload

Création du dépôt subversion

Sur le site Prendre un café, j'ai trouvé un script qui automatisait la création de dépôts subversion.

Cliquez voir cet article qui indique la marche à suivre pour installer Subversion et Trac sur un serveur Ubuntu !

Merci en tout cas à Niko, l'auteur du script de m'avoir fait gagner un précieux temps

Des liens

Voir en ligne : Subversion

Les paquets Debian

Aternatik — 2007-08-29T21:30:13Z

Explications sur le fonctionnement des paquets Debian. Aperçu rapide des commandes pour aller plus loin que la simple installation d'un logiciel sur sa distribution GNU/Linux.

C'est pourtant si simple...

Configurer un système entier à partir de son code source est long et il faut être très exigeant si on veut que les applications soient correctement configurées (et cohérentes). La distribution Debian GNU/Linux est reconnue pour son système de gestion des logiciels : les paquets (ou fichier *.deb). Quand vous installez un logiciel sur votre distribution [1] grâce au gestionnaire de paquets, vous êtes assurés d'une configuration "taillée" pour votre système. Un paquet contient les sources du logiciel ainsi que les options de configuration spécifiques à Debian.

Avant d'être inclus dans une dépôt, il faut empaqueter les sources. Les options de configuration sont dans le ficher debian/rules d'un paquet debian.

[*Si vous n'avez jamais compilé un logiciel, passez votre chemin *]

Pour compiler une appli à partir des sources, il faut exécuter ces commandes :

# ./configure
# make
# make install

Télécharger

Seulement cela se complique souvent quand il faut passer les bonnes options à ./configure. Et puis il faut aussi nettoyer le répertoire des sources, si on veut relancer la compilation... Le fichier rules facilite l'installation de paquet car les actions à faire sont indiqués dans ce fichier... Exemple de fichier rules :

install: build
dh_testdir
dh_testroot
dh_clean -k
dh_installdirs
@# Add here commands to install the package into debian/tmp
done
# Build architecture-independent files here.
binary-indep: build install
# We have nothing to do by default.
# Build architecture-dependent files here.
binary-arch: build install
dh_testdir
dh_testroot
# dh_movefiles
dh_installdebconf
dh_installdocs
# dh_installexamples
# dh_installmenu
# dh_installlogrotate
# dh_installemacsen

Télécharger

Petit mémo de commande

Télécharger les sources d'un paquet Débian (ajouter deb-src à votre fichier apt/sources.list)

apt-get source nomdupaquet

La structure du paquet est disponible, ainsi que le fameux fichier debian/rules

Ajuster les options voulues et pour le reconstruire par la suite, utiliser :

dkg-builpackage -bfakeroot

Enregistrer/copier la configuration du système

Ce qui suit permet de faire un état des paquets installés sur un système. Pour faire une copie locale de l'état de la sélection des paquets :

# dpkg --get-selections "*" >myselections

"*" inclut aussi les noms des paquets à purger dans myselections.

Transférer ces fichier vers un autre ordinateur, et installer les paquets avec :

- # dselect update
- # dpkg --set-selections < myselections
- # apt-get -u dselect-upgrade # ou dselect install

Télécharger

Des liens

A suivre : la construction d'un paquets à partir des sources d'une application...

Voir en ligne : Guide de référence pour les paquets Debian

[1] Il y a trois versions de Debian : stable, testing et untable.

Alias de commande : fichier .bashrc

Aternatik — 2006-11-07T20:25:42Z

C'est souvent fatiguant de tout le temps tapoter les mêmes commandes dans la console sous unix. On a beau avoir le dernier clavier ergonomique qui fatigue pas les mains et qui repose le poignet (...) à la mode, il est possible de créer de petits raccourcis autrement représenté par une fenêtre. Dehors les dessins, bonjour les alias. Modification du fichier /.bashrc, un peu de couleur au passage et création de /.bash_aliases.

2Fichier /.bashrc2 Pas de blabla sur la console unix, on peut vite se rendre compte que beaucoup de commandes deviennent répétives (sisi... on me l'a dit.) :

ssh user@domain.tld
 ls -lisa

3On n'est pas des fainéants, il faut faire les manips3 Donc on va faire un tour dan le fichier /.bashrc

vi ~/.bashrc Pour un peu de couleur dans l'invite (ou prompt), décommenter cette ligne : PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$'

Les alias Plus loin dans .bashrc, il suffit de décommenter trois lignes pour disposer de notre propre fichier d'alias de commande. (Cf commentaires...)

On va donc faire ce /.bashrc_aliases pour ne pas polluer le fichier de config de bash. On va aussi profiter de l'élan pour mettre les alias de commande.

vi ~/.bash_aliases
 # on ajoute les alias 
 alias macommande='~/Scripts/commande.sh'
 alias lisa='ls -lisa'
 
 #On quitte vi
 [ech]:wq

On n'a plus qu'à demander lisa pour que le listage de dossier fourmille d'infos... C'est pas beau ça :D

Ce soir c'est automatisation des tâches...

Au passage, un petit lien sur l'administration distante. Identification "automatique" avec ssh, screen qui lui aussi est bien pratique.

Commande DOS principales

Aternatik — 2006-10-24T08:42:48Z

Aide mémoire sur les principales commandes utilisées sous DOS (Disk Operating System).

attrib – Permet d'afficher, de définir ou de supprimer au moins l'un des quatre attributs pouvant être affectés aux fichiers et aux répertoires. Ces quatre attributs sont : lecture seule, archive, système et caché. attrib est une commande DOS externe. Un signe plus (+) ou moins (-) utilisé dans la commande attrib paramètre ou supprime respectivement un attribut. Le format utilisé est le suivant :

attrib [ {+ or -} ] [{variable}] [{répertoire\nom du fichier}] /[{commutateur}]

Les variables suivantes peuvent être utilisées avec la commande attrib :

r – Indique un fichier en lecture seule.
a – Indique une archive.
s – Indique un fichier système.
h – Indique un fichier caché.

del – Cette commande efface les fichiers nommés. Les commandes del et erase sont synonymes. Le commutateur communément utilisé, /p, permet de demander à l'utilisateur de confirmer sa demande avant d'effacer chaque fichier. Le format utilisé est le suivant :

del [{répertoire\nom du fichier}] /[{commutateur}]

edit – Cette commande externe permet à l'utilisateur d'afficher, de créer ou de modifier un fichier. Le format utilisé est le suivant :

edit [{répertoire\nom du fichier}] /[{commutateur}]

Les commutateurs suivants sont communément utilisés avec la commande edit :

b – Force le mode monochrome.
h – Affiche le nombre de lignes maximum autorisé pour le matériel.
r – Charge des fichiers en mode lecture seule.
/[fichier] – Spécifie les fichiers initiaux à charger. Des caractères de remplacement et plusieurs spécifications de fichiers peuvent être donnés.

format – Cette commande externe est utilisée pour effacer toutes les informations d'une disquette ou du disque dur. Elle peut être utilisée pour la préparation du disque dur à l'installation d'un OS Windows. La commande format standard est présentée ci-après : format [{lecteur}] /[{commutateur]}

Les commutateurs suivants sont communément utilisés avec la commande format :

q – Effectue un formatage rapide mais n'efface pas la table FAT. La récupération du fichier est donc possible.
s – Copie les fichiers système sur le disque formaté.
u – Effectue un formatage inconditionnel. Toutes les données précédentes, y compris la table FAT, sont irrémédiablement effacées.

REMARQUE : Le commutateur /s doit être ajouté lors du formatage d'un disque système. Si ce commutateur n'est pas utilisé, le disque peut être reformaté ou bien la commande DOS sys peut être utilisée.

fdisk – Cette commande externe permet à l'utilisateur d'effacer et de créer des partitions sur le disque dur. Elle est communément utilisée pour préparer le disque dur à l'installation d'un OS Windows. Le format de la commande est présenté ci-après : fdisk /[{commutateur}]

Un commutateur fréquemment utilisé, /status, affiche des informations de partition lorsqu'il est associé à la commande fdisk.

scandisk – Cette commande est un programme DOS conçu pour détecter et réparer des erreurs sur un disque dur ou sur une disquette. Elle est entrée à l'invite comme suit : scandisk /[commutateur]

Les commutateurs fréquemment utilisés avec la commande scandisk sont présentés ci-après :

all – Vérifie et répare tous les lecteurs locaux au même moment.
checkonly – Recherche les erreurs présentes dans le lecteur, mais n'effectue pas de réparation.
autofix – Répare automatiquement les erreurs et enregistre les clusters par défaut sous forme de fichiers dans le répertoire racine.

mem – Cette commande externe permet d'afficher une table présentant l'affectation actuelle de la mémoire. Elle s'utilise comme suit à l'invite de commande : mem /[commutateur]

Les commutateurs communément utilisés avec la commande mem sont les suivants :

c – Liste les programmes chargés en mémoire et montre la quantité de mémoires conventionnelle et supérieure utilisée par chaque programme.
d – Liste les programmes et les pilotes internes chargés en mémoire.
f – Liste les zones libres des mémoires conventionnelle et supérieure (qui seront traitées ultérieurement dans ce module).
p – Effectue une pause après chaque écran d'informations.

copy – Cette commande est fréquemment utilisée pour copier un ou plusieurs fichiers d'un emplacement à un autre. Elle permet également de créer des fichiers. En utilisant la commande copy con pour copier des fichiers de la console clavier vers l'écran, des fichiers peuvent être créés, puis sauvegardés sur le disque. Les commutateurs communément utilisés avec la commande copy sont les suivants :

y – Remplace des fichiers existants sans afficher d'invite de confirmation.
-y – Affiche une invite de confirmation avant de supplanter des fichiers existants.
a – Copie des fichiers ASCII. S'applique au fichier la précédant et à tous les fichiers suivants.
b – Copie des fichiers binaires. S'applique au fichier la précédant et à tous les fichiers suivants.
v – Vérifie la copie effectuée pour s'assurer qu'un fichier a été copié correctement. Si la copie ne peut pas être vérifiée, le programme affiche un message d'erreur.

more – Affiche les sorties un écran à la fois. Cette commande est entrée comme suit : more [nom de fichier]

Les commandes cd, mkdir, rmdir et deltree sont légèrement différentes car elles n'utilisent pas de commutateurs. Une rapide description de ces commandes suit :

cd – Modifie ou affiche le répertoire courant sur le lecteur spécifié.
mkdir ou md – Crée un nouveau répertoire.
rmdir ou rd – Efface un répertoire vide. Cette commande ne peut être utilisée qu'après avoir supprimé ou déplacé tous les sous-répertoires et fichiers du répertoire concerné.
deltree – Efface un répertoire, ainsi que tous les fichiers et sous-répertoires qu'il contient.