Minimalteck.fr

Un mail avec accusé de reception en PHP

Minimalteck — 2010-01-28T11:45:20Z

Vous connaissez certainement cette agaçante propention qu'ont certains utlisateurs à vous envoyer des courriels - généralement sources de tracas - s'accompagnant d'une agression à la pop-up au sein de votre client de messagerie…
Rien de mieux pour mettre de fâcheuse humeur…
Oh ! Comble de l'horreur, on vous demande au cours d'un dév de générer des envois de mails avec accusé de réception… Rhâaaaaaaa !!!

Au cours du débat animé qui s'en suit sur la question, un de vos collègues, le sourire en coin, vous pose THE problématique :
"Mais, sinon toi, tu saurais comment faire ?"" title=":->" class="no_image_filtrer format_png" src="http://www.minimalteck.fr/plugins/couteau_suisse/img/smileys/diable.png" width="19" height="19"/>
C'est l'objet même de cet article ou comment claquer le bec de ce malotru qui a voulu vous prendre en défaut…

En fait, c'est tout a fait trivial… Il suffit d'ajouter des en-têtes appopriées à votre mail : "Return-Receipt-To :", non définie par quelque norme que ce soit, mais couramment admis et utilisé et la seconde "Disposition-Notification-To" définie quant à elle par la RFC 3798

Disposition-Notification-To: courriel@emetteur.com
 Return-Receipt-To: courriel@emetteur.com

Bête et méchant, il faut juste s'en rappeler.

Plugin SPIP : diaporama avec jQuery

Minimalteck — 2009-08-17T11:26:32Z

Sommaire

Présentation du plugin Spip jQuery Cycle :

" sjcycle " est un diaporama paramétrable pour Spip basé sur la librairie javascript jQuery et les plugins :

Développé pour Spip [2.0.x] il utilise :

les formulaires CVT ;
le moteur de configuration CFG [1.10] ;
les modèles pour une insertion aisée dans le texte des articles.

- Fonctionnalités principales :

Paramétrage des effets, de la vitesse de transition, de la taille du diaporama, etc.
Possibilté d'afficher plusieurs diaporama au sein d'un même article
Possibilté de sélectionner les images à associer à chaque diaporama

Décryptage de la syntaxe et paramètres du raccourci typographique "sjcycle"

Le raccourci typographique "sjcycle" permet d'insérer facilement un ou plusieurs diaporamas au sein d'un article : il vous suffit de le recopier à l'intérieur de la case « Texte » de l'article, là vous désirez situer le diaporama.

Ce raccourci comporte jusqu'à 3 paramètres, ordonnés et séparés par le caractère "|".

Premier paramètre, "N", obligatoire :
Correspond au numéro de l'article en cours.
Il permet de cibler les images liées à un unique article.
Astuce : Vous pouvez ainsi insérer un diaporama avec les images d'un article dans un autre article.
Second paramètre, "|ALIGN", optionnel :
Permet de spécifier l'alignement du diaporama au sein du texte.
S'il n'est pas précisé, l'alignement est "center".
Les options de l'alignement :
1. "left" : à gauche du texte ;
2. "center" : centrer dans le texte ;
3. "right" : à droite du texte.
Troisième paramètre, "|docs=n1,n2,[…],nx", optionnel :
Permet de spécifier la liste d'images à afficher dans le diaporama.
Ainsi, on peut afficher plusieurs diaporamas dans au sein d'un même texte, isoler des images.
S'il n'est pas précisé, l'ensemble des images sont sélectionnées par défaut.
Les arguments de sélection "n1,n2,[…],nx" du paramètre "|docs=" :
Ils se composent d'une suite de numéros d'images séparées par des virgules sans espace.
Sous chaque image est indiqué un raccourci typographique du type "", "" ou "", où "XX" désigne le numéro de l'image correspondante.
Ainsi le paramètre "|docs=1,3", sélectionne les images numéro 1 et 3 de l'article courant.
Astuce : Vous pouvez utiliser le raccourci en ne passant qu'un seul numéro d'image au paramètre "|docs=" afin de bénéficier de l'effet "FancyBox" : un clic sur l'image redimensionnée du diaporama permet d'afficher l'image originale en superposition.

Ce qu'il faudrait faire…

Intégrer plus d'options du jQuery Cycle Plugin ;

Créer la fonction d'install du plugin pour installer les paramètres par défaut lors de l'activation du plugin et surtout nettoyer les "metas" lors de sa désactivation… J'ai rencontré un problème lors de cette mise en place :

 if (!defined("_ECRIRE_INC_VERSION")) return;
 function sjcycle_install($action){
 include_spip('sjcycle_fonctions');
 switch ($action){
 case 'test':
 //Contrôle du plugin à chaque chargement de la page d'administration
 // doit retourner true si le plugin est proprement installé et à jour, false sinon
 if(!lire_config('sjcycle')){
 return true;
 } else {
 return false;
 }
 break;
 case 'install':
 //Appel de la fonction d'installation. Lors du clic sur l'icône depuis le panel.
 //quand le plugin est activé et test retourne false
 if(!lire_config('sjcycle')){
 ecrire_config('sjcycle',serialize(init_sjcycle_default('default_value_list')));
 }
 break;
 case 'uninstall':
 //Appel de la fonction de suppression
 //quand l'utilisateur clique sur "supprimer tout" (disponible si test retourne true)
 effacer_config('sjcycle');
 return true;
 break;
 } 
 }
 ?>

le code me semblait pourtant correct, mais à chaque fois que le cas 'test' (affichage de la gestion des plugin, le système écrasait les valeur par celles par défaut…
Même en passant par lire_meta() en lieu et place de la version fournie par CFG… je n'ai pas plus creusé que ça… c'est sûrement tout bête !

compacter les css ;

etc.

Pour conclure

Ce plugin s'adresse avant tout aux personnes désireuses d'agrémenter leur site SPIP de diaporamas légers mais performants, avec un descriptif de l'image en survol, un affichage en superposition.

Actuellement taggé en "test", ce plugin est cependant totalement fonctionnel et est utilisé sur des sites en production.

Démonstration

Une première séries d'images…

Et voici lz seconde, avec titres et descriptifs…

Un PEAR Pager_Wrapper pour PDO

Minimalteck — 2008-10-31T17:32:13Z

Selon le PEAR ::Pager tutorials de Lorenzo Alberton, voici un Wrapper Pager/PDO, inspiré largement du Pager_Wrapper contenu dans la doc du package.

 // SAMPLE USAGE
 // ------------
 //
 // $query = 'SELECT this, that FROM mytable';
 // require_once 'Pager_Wrapper.php'; //this file
 // $pagerOptions = array(
 // 'mode' => 'Sliding',
 // 'delta' => 2,
 // 'perPage' => 15,
 // );
 // $paged_data = Pager_Wrapper_MDB2($db, $query, $pagerOptions);
 // //$paged_data['data']; //paged data
 // //$paged_data['links']; //xhtml links for page navigation
 // //$paged_data['page_numbers']; //array('current', 'total');
 //
 
 /**
 * Helper method - Rewrite the query into a "SELECT COUNT(*)" query.
 * @param string $sql query
 * @return string rewritten query OR false if the query can't be rewritten
 * @access private
 */
 function rewriteCountQuery($sql)
 {
 if (preg_match('/^\s*SELECT\s+\bDISTINCT\b/is', $sql) ||
 preg_match('/\s+GROUP\s+BY\s+/is', $sql) ||
 preg_match('/\s+UNION\s+/is', $sql)) {
 return false;
 }
 $open_parenthesis = '(?:\()';
 $close_parenthesis = '(?:\))';
 $subquery_in_select = $open_parenthesis.'.*\bFROM\b.*'.$close_parenthesis;
 $pattern = '/(?:.*'.$subquery_in_select.'.*)\bFROM\b\s+/Uims';
 if (preg_match($pattern, $sql)) {
 return false;
 }
 $subquery_with_limit_order = $open_parenthesis.'.*\b(LIMIT|ORDER)\b.*'.$close_parenthesis;
 $pattern = '/.*\bFROM\b.*(?:.*'.$subquery_with_limit_order.'.*).*/Uims';
 if (preg_match($pattern, $sql)) {
 return false;
 }
 $queryCount = preg_replace('/(?:.*)\bFROM\b\s+/Uims', 'SELECT COUNT(*) FROM ', $sql, 1);
 list($queryCount, ) = preg_split('/\s+ORDER\s+BY\s+/is', $queryCount);
 list($queryCount, ) = preg_split('/\bLIMIT\b/is', $queryCount);
 return trim($queryCount);
 }
 
 /**
 * PDO's version of Pager_Wrapper
 * @param object PDO instance
 * @param string db query
 * @param array PEAR::Pager options
 * @param boolean Disable pagination (get all results)
 * @param integer fetch mode constant
 * @return array with links and paged data
 */
 function Pager_Wrapper_PDO($db, $query, $pager_options = array(), $disabled = false, $fetchMode = PDO::FETCH_ASSOC){
 if (!array_key_exists('totalItems', $pager_options)) {
 if ($countQuery = rewriteCountQuery($query)) {
 $stmt = $db->prepare($countQuery);
 $stmt->execute();
 $totalItems = $stmt->fetchColumn();
 }else{
 $stmt = $db->prepare($query);
 if (!$stmt) {
 echo "\nPDO::errorCode(): ";
 print $db->errorCode();
 die();
 }
 $stmt->execute();
 if ($stmt->execute() === FALSE) {
 echo "\nPDO::errorCode()toto: ";
 print $db->errorCode();
 die();
 }
 $rows = $stmt->fetchAll(PDO::FETCH_COLUMN);
 $totalItems = count($rows);
 
 }
 $pager_options['totalItems'] = $totalItems;
 }
 require_once 'Pager/Pager.php';
 $pager = Pager::factory($pager_options);
 
 $page = array();
 $page['links'] = $pager->links;
 $page['totalItems'] = $pager_options['totalItems'];
 $page['page_numbers'] = array(
 'current' => $pager->getCurrentPageID(),
 'total' => $pager->numPages()
 );
 list($page['from'], $page['to']) = $pager->getOffsetByPageId();
 $page['limit'] = $page['to'] - $page['from'] +1;
 
 // fix offset
 // limit 1,10 can not retrive the first record of result set.
 $page['from'] = $page['from'] - 1;
 
 if (!$disabled) {
 $query .= ' LIMIT ' . $page['from'] . ', ' . $pager_options['perPage'];
 }
 // var_dump($query);
 $stmt = $db->prepare($query);
 if (!$stmt) {
 echo "\nPDO::errorCode(): ";
 print $db->errorCode();print_r($db->errorInfo());
 die();
 }
 $stmt->execute();
 $page['data'] = $stmt->fetchAll($fetchMode); 
 if ($disabled) {
 $page['links'] = '';
 $page['page_numbers'] = array(
 'current' => 1,
 'total' => 1
 );
 } 
 
 // var_dump($pager);
 return $page;
 }
 
 
 
 ?>

Bon le code est pas fignolé… mais on peut déjà l'utiliser à des fins de tests :

 require_once('DatabaseConnection.class.php');
 //copy the Pager_Wrapper file where you can include it
 require_once './Pager_Wrapper.php';
 $db = DatabaseConnection::get()->handle();
 $db->setAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY, true);
 //skipped the db connection code...
 //let's just suppose we have a valid db connection in $db.
 
 $pager_options = array(
 'mode' => 'Sliding',
 'perPage' => 2,
 'delta' => 2,
 );
 $query = 'SELECT * FROM person';
 $paged_data = Pager_Wrapper_PDO($db, $query, $pager_options);
 
 //show the results
 echo '';
 foreach ($paged_data['data'] as $product) {
 echo ''.$product['id_person'].': '.$product['name'].'
';
 }
 echo '
';
 
 //show the links
 echo $paged_data['links'];
 ?>

le PDO ::MYSQL_ATTR_USE_BUFFERED_QUERY est mis à TRUE pour permettre d'effectuer des requêtes multiples sur la même connexion…
Sinon 'a marche pô !!!
Du moins sur ma plateforme de test à l'arrache…

Alors que dans la littérature, j'eu appris que la fermeture du 'PDO cursor' règlait le pb, via la PDOStatement ::closeCursor…
c'est même indiqué dans la doc PDO : "PDOStatement->closeCursor — Ferme le curseur, permettant à la requête d'être de nouveau exécutée"

Classe Objet générique

Minimalteck — 2008-10-31T10:12:12Z

Sommaire

La classe :

Classe abstraite pour créer/modifier/supprimer des objets construits à partir d'une base de données, ici mysql (Auto_increment) et utilisant PDO

 require_once('DatabaseConnection.class.php');
 abstract class GenericObject {
 
 protected $table;
 protected $fields;
 protected $primary_key;
 protected $id = NULL;
 private $data = array();
 private static $db;
 private $autoIncrement = true;
 
 
 
 public function __construct($id=NULL){
 $this->db = DatabaseConnection::get()->handle();
 if ( (!is_null($id)) && (is_numeric($id))) {
 $this->id = $id;
 $this->load(); 
 }
 }
 
 public function __destruct(){
 
 }
 
 public function __set($key, $value) {
 $this->$key = $value;
 }
 
 
 function __get($key) {
 return $this->$key;
 }
 
 public function autoIncrement($bool){
 if(is_bool($bool)){
 $this->autoIncrement = $bool;
 }
 }
 
 public function load() {
 $this->db = DatabaseConnection::get()->handle();
 $sql = 'SELECT '.implode(', ',$this->fields).' FROM `'. $this->table .'` WHERE ';
 $sql .=' `'.$this->primary_key.'` = "'.$this->id.'" LIMIT 1;';
 
 $sth = $this->db->query($sql);
 $result = $sth->fetch(PDO::FETCH_ASSOC);
 if (is_array($result)) {
 $this->data = $result;
 }
 unset($result);
 }
 
 public function save(){
 $this->db = DatabaseConnection::get()->handle();
 
 if(is_null($this->id) && $this->autoIncrement){//INSERT A NEW RECORD
 $sql = 'SHOW TABLE STATUS LIKE "'.$this->table.'"';
 $sth = $this->db->query($sql);
 $row = $sth->fetch(PDO::FETCH_ASSOC);
 $this->id= $row['Auto_increment'];
 $sth->closeCursor();
 }
 
 $bind_array = array();
 $sql_stmt = 'REPLACE INTO ' .$this->table. ' SET';
 foreach($this->data as $field => $value) {
 $bind_array[] = $this->db->quote($value);
 $sql_stmt .= ' '.$field.' = ? ,';
 }
 $sql_stmt = substr($sql_stmt,0,-1);
 
 $stmt = $this->db->prepare($sql_stmt);
 if (!$stmt) {
 echo "\nPDO::errorInfo():\n";
 print_r($this->db->errorInfo());
 } else {
 if ($stmt->execute($bind_array) === false){
 $error = $this->db->errorInfo();
 print_r($error);
 die();
 } else {
 return true;
 }
 }
 
 
 
 
 
 
 }
 
 
 public function remove(){
 if (!is_null($this->id)) {
 $this->db = DatabaseConnection::get()->handle();
 $sql = 'DELETE FROM ' .$this->table. ' WHERE '.$this->primary_key.'=' . $this->id .';';
 if (!$this->db->exec($sql)) {
 $error = $this->db->errorInfo();
 print_r($error);
 } else {
 return true;
 }
 
 }
 }
 
 
 public function getDatas(){
 return $this->data;
 }
 
 public function setDatas($assign_values){
 foreach ($assign_values as $key => $value) {
 $this->data[$key] = $value;
 }
 }
 
 }
 ?>

Son utilisation :

Il suffit d'étendre la classe pour créé un nouvel objet, en affectant :
la table de données ("$table") ;
les valeurs des colonnes de cette table ("$fields") ;
la clé primaire ("$primary_key").

Exemple :

 require_once('GenericObject.class.php');
 class Person extends GenericObject {
 protected $table = 'person';
 protected $fields = array('id_person',
 'name',
 'firstname',
 'email');
 protected $primary_key = 'id_person';
 }
 ?>

Require : DatabaseConnection.class.php

Singleton PDO

Minimalteck — 2008-10-31T09:58:21Z

Sommaire

La classe singleton :

 class DatabaseConnection {
 
 public static function get() {
 static $db = null;
 if ( $db == null ) {
 $db = new DatabaseConnection();
 }
 return $db;
 }
 
 private $_handle = null;
 
 private function __construct() {
 $this->engine = 'mysql';
 $this->host = 'localhost';
 $this->database = 'nom_base';
 $this->user = 'user';
 $this->pass = 'user_password';
 $dns = $this->engine.':dbname='.$this->database.";host=".$this->host;
 try {
 $this->_handle = new PDO( $dns, $this->user, $this->pass );
 $this->_handle->query("SET NAMES utf8");//FOR USING UTF-8
 $this->_handle->query("SET CHARACTER SET 'utf8'");//FOR USING UTF-8
 return true;
 } catch (PDOException $e){
 print 'Erreur : '.$e->getMessage().'
';
 die();
 }
 }
 
 public function handle() {
 return $this->_handle;
 }
 }
 ?>

Son utilisation :

 $dbx = DatabaseConnection::get()->handle();
 $results=$dbx->query('SELECT * FROM bidule'); 
 $results->setFetchMode(PDO::FETCH_OBJ); // retour d'un objet std
 while( $row = $resultats->fetch() ) {
 echo 'Utilisateur : '.$row->id.'
'; // on affiche l'id des entrées de la table bidule
 }
 $results->closeCursor(); // on ferme le curseur des résultats : nécessaire pour pouvoir réutiliser la connexion $dbx pour exécuter une nouvelle requête...
 ?>

Minimalteck.fr

Un mail avec accusé de reception en PHP

Plugin SPIP : diaporama avec jQuery

Présentation du plugin Spip jQuery Cycle :

Décryptage de la syntaxe et paramètres du raccourci typographique "sjcycle"

Ce qu'il faudrait faire…

Pour conclure

Démonstration

Roulage à Carole

Départ...

Retour au stand

Un PEAR Pager_Wrapper pour PDO

Classe Objet générique

La classe :

Son utilisation :

Singleton PDO

La classe singleton :

Son utilisation :