Pré-requis :

• Avoir une application Sugar CRM déployée et paramétrée sur le serveur
• Connaître les notions de base de la programmation PHP orientée objet

Etape 1 : Créer une instance PHP de Sugar CRM

La première étape est de rendre disponible les fonctionnalités de Sugar. Nous allons stocker les objets Sugar de base (Client, Proxy, Session) dans des variables php.

require_once('./Sugar/include/nusoap/nusoap.php'); //librairie SOAP de sugar crm
$soapclient = new nusoapclient('http://www.monserveur.com/Sugar/soap.php?wsdl',true); //création d'une instance Sugar
$soapproxy = $soapclient->getProxy();
$soapsession = $soapclient->call('login',array('user_auth'=>array('user_name'= 'monidentifiant',
   'password'=> md5('monmotdepasse'), 'version'=>'.01'), 'application_name'=>'SoapSugar'));
$soapsessionid = $soapsession['id'];

Dans ce script j’attire surtout votre attention sur deux points :

• l’instance ‘soapclient’ utilise l’url du site plutôt que le chemin d’accès au script sur le serveur
• le mot de passe indiqué pour créer la session Sugar CRM doit être converti en MD5

Etape 2 : Vérifier l’existence d’un contact Sugar CRM à partir de son adresse email

$email = 'sos@itx-technologies.com';
$query = 'Contacts.id in (SELECT eabr.bean_id FROM email_addr_bean_rel eabr JOIN email_addresses ea ON
   (ea.id = eabr.email_address_id) WHERE eabr.deleted=0 and ea.email_address = "'. $email .'")';
$orderby = 'Contacts.id DESC';
$result = $soapproxy->get_entry_list(
$soapsessionid, 'Contacts', $query, $orderby, 0, //offset
   array('id'), //champs retournés dans la réponse
   1, //nombre maximum de résultat retournés
   false //deleted
);
 
$account_id = $result['entry_list'][0]['id'];

Dans cette deuxième étape, nous utilisons directement une des fonctions de l’API Sugar, get_entry_list. Vous remarquerez que nous lui passons en paramètre l’identifiant de la session en cours pour confirmer que nous sommes autorisés à utiliser l’application Sugar ainsi qu’une partie de la requête SQL qui permet de faire la jointure entre le module Contacts et les adresses mail stockées dans la table « email_adresses« .

Finalement, la variable $account_id a une valeur à NULL ou bien une clé id si au moins un contact a été trouvé.

Ce premier exemple de SOAP vous permettra de confirmer que tout fonctionne correctement et que votre environnement Sugar CRM est bien rappatrié dans l’objet. Vous pourrez alors construire une classe dédiée au SOAP avec une initialisation des objets Client, Proxy et Session dans le constructeur et des fonctions dédiées de manipulation des données de Sugar. Faites nous part de vos essais !

<?php
// Tiré de codex.wordpress.org
global $wp_query;
 
$big = 999999999; // need an unlikely integer
 
echo paginate_links( array(
	'base' => str_replace( $big, '%#%', get_pagenum_link( $big ) ),
	'format' => '?paged=%#%',
	'current' => max( 1, get_query_var('paged') ),
	'total' => $wp_query->max_num_pages
) );
?>

Copiez ce code dans le fichier index.php, archives.php, search.php ou peu importe là où vous voulez avoir une pagination !

Mais à quoi bon s’auto-pinger ? Lorsque vous faites un lien vers un article de votre propre blogue, WordPress ne fait pas la distinction entre votre site ou un autre, alors il créera un commentaire sous l’article vers lequel vous avez fait un lien, comme si c’était un autre site qui venait de vous envoyer un rétrolien.

Comment désactiver les auto-rétroliens

Il suffit d’écrire une fonction dans votre fichier functions.php et de hooker cette fonction à l’action pre_ping qui est exécutée juste avant que WordPress ne génère les pings.

// Désactiver les rétroliens vers son propre site
function mes_retroliens( &$liens ) {
    $home = get_option( 'home' );
    foreach ( $liens as $l => $lien )
        if ( 0 === strpos( $lien, $home ) )
            unset($liens[$l]);
}
add_action( 'pre_ping', 'mes_retroliens' );

La fonction, écrite par un membre des forums de WordPress, va parser le ou les liens de votre articles, et si elle découvre qu’un de ces liens possède l’URL de votre site, elle ne la comptera pas dans les rétroliens à faire.

Pour les non-initiés, la commande grep, exécutée dans un terminal Linux, sert à rechercher une expression donnée à l’intérieur d’un ou de plusieurs fichiers.

Exemple

Cela dit, lorsque vous exécutez une commande, par exemple :

$ grep -R include wp-content/*

le résultat de la commande, qui cherche l’expression « include » dans tous les fichiers du dossier, et sous-dossiers, de wp-content, donnera quelque chose du genre :

$ grep -R include wp-content/*
plugins/akismet:    odeValue=trimAndGetNodeText(table.config,node);if(table.config.debug){log('Checking if value was empty on row:'+rowIndex);}}else{keepLooking=false;}}for(var i=1;i<l;i++){if(parsers[i].is(nodeValue,table,node)){return parsers[i];}}return include[0];}function getNodeFromRowAndCellIndex(rows,rowIndex,cellIndex){return rows[rowIndex].cells[cellIndex];}function trimAndGetNodeText(config,node){return $.trim(getElementText(config,node));}function getParserById(name){var l=parsers.length;for(var i=0;i<l;i++){if(parsers[i].id.toLowerCase()==name.toLowe
themes/twentyten:   :function(){var parsers=[],widgets=[];this.include={cssHeader:"header",cssAsc:"headerSortUp",cssDesc:"headerSortDown",cssChildRow:"expand-child",sortInitialOrder:"asc",sortMultiSortKey:"shiftKey",sortForce:null,sortAppend:null,sortLocaleCompare:true,textExtraction:"simple",parse

En fait, c’est que la commande renvoit la ligne de code, dans le fichier, où l’expression (en l’occurrence include) a été trouvée. Le gros désavantage c’est que votre terminal est rempli de lignes de code et cela devient très difficile à lire lorsque vous avez des centaines de résultats à votre requête.

La commande qui vous faut

C’est simple : il vous suffit simplement d’ajouter l’option -l (grep -l) pour que seulement le nom du fichier sera affiché. Dans notre exemple, cela deviendrait :

$ grep -lR include wp-content/*

Ah, que c’est beau Linux !

Pour ceux qui tomberont sur ce petit didactiel très simple savent très bien ce dont je parle : nous pouvons faire un JOIN avec une table mais nous ne pouvons pas le faire 2 fois avec la même table !

Pour ce faire, il faut utiliser des synonymes :

Exemple

Prenons la table « articles » avec les champs id, titre, cree_par_id, modifie_par_id.  Nous voulons créer une requête en la joignant avec la table « utilisateurs » qui possède les champs id, nom. Nous voulons avoir :

titre de l’article, créer par (nom), modifié par (nom)

Les champs cree_par_id et modifier_par_id comprennent les ID des utilisateurs mais nous voulons leur nom alors il faudra faire 2 fois le JOIN :

JOIN #1 : articles.cree_par_id et utilisateurs.id
JOIN #2 : articles.modifie_par_id et utilisateurs.id

La requête

Alors, ce qu’il faut faire, c’est donner un synonyme à la table « articles » car autrement, l’engin MySQL ne nous laissera pas faire 2 JOIN.

SELECT a1.titre, a1.cree_par_id, a2.modifie_par_id
 
LEFT JOIN articles a1 
    ON utilisateur.`id` = a1.`cree_par_id`
LEFT JOIN articles a2 
    ON utilisateur.`id` = a2.`modifie_par_id`

Voilà, comme on peut voir, nous créons deux JOIN : la première fois avec la table a1 (premier synonyme de « articles ») et ensuite avec a2 (deuxième synonyme de « articles »).