Si comme moi vous avez tenté d’utiliser la directive .suffix dans le routing.yml

prod:
  routing:
    param:
      suffix: .html

et que vous vous attendiez à ce que vorte suffixe .html soit ajouté automatiquement à tous les liens générés via link_to et gen_url … c’est que vous ne savez pas que par défaut symfony génère des urls aussi courtes que possible.

Il vous faudra donc changer ce comportement dans factories.yml

all:
  routing:
    class: sfPatternRouting
    param:
      generate_shortest_url: false

En effet l’approche RAD proposée par ce framework rend d’autant plus crucial le schéma de base de données, sur lequel est basé l’application. Ce schéma matérialisé par le fichier schema.yml (ou .xml si vous utilisez propel) est en quelque sorte la feuille de route du développeur agile.

Il est intéressant de remarquer qu’une modélisation graphique de ce schéma donne un point de vue (partiel certes) sur le système d’information que l’applicaiton sert …

Il ya déjà quelques temps déjà j’avais cherché à automatiser la modification du schéma géré par symfony via des outils graphiques (Utiliser DBDesigner avec l’i18n de symfony 1.0)

Aujourd’hui je vous propose un petit tour d’horizon des solutions à votre disposition selon vos outils et votre orm préférés

DbDesigner

si vous utilisez propel

• Le plugin sfDB4toPropelPlugin automatisera le processus de conversion du schéma sauvé par DbDesigner en un schema.yml (à la manière des scritps cités précédemment)

si vous utilisez Doctrine

le plugin sfDbDesignerPlugin ne s’installe pas correctement via la commande symfony. En revanche en l’installant manuellement, i.e. en téléchargeant l’archive directement sur le site et en la décompressant dans /plugins/sfDbDesignerPlugin puis en activant le plugin dans /config/ProjectConfiguration.class.php

<?php

require_once dirname(__FILE__).'/..\lib\vendor\symfony\lib/autoload/sfCoreAutoload.class.php';
sfCoreAutoload::register();

class ProjectConfiguration extends sfProjectConfiguration
{
  public function setup()
  {
    $this->enablePlugins('sfDoctrinePlugin');
    $this->enablePlugins('sfDbDesignerPlugin');
  }
}

vous aurez accès à la task

php symfony dbdesigner:convert-doctrine doc/database.xml

Où doc/database.xml est le path vers le fichier DBDesigner.
Si vous n’avez pas une application nommée frontend il faudra la passer ne paramètre

php symfony dbdesigner:convert-doctrine --application=myapp doc/database.xml

vous obtiendrez alors un fichier « ready to build » du schéma modélisé avec DBDesigner dans config/doctrine/schema.yml

MySQLWorkBench

Il est à noter que MySQLWorkbench est un fork de DBDesigner4, mais il ne peut pas remplacer ce dernier. En effet si MySQLWorkbench sait parfaitement importer un fichier xml produit par DbDesigner4, il est en revanche incapable d’exporter ce schéma au format xml de DbDesigner4.  MySQLWorkbench ne permet que d’enregistrer au format mwb.

Ce format est en fait un zip, qui une fois décompresser donne un fichier xml, mais qui n’a rien à voir avec le xml généré par DBDesigner4, le fichier xml issu du .wmb est donc inutilisatble avec les deux plugins ci dessus.

MySQLWorkbench bénéficie en revanche d’une bibliothèque de plugins qui permettent de l’utiliser en remplaçant de DBDesigner.

Pour installer un plugin dans MySQLWorkbench il suffit de copier le fichier .lua qui contient le code du plugin (du Python Like) dans le répertoire « modules » du répertoire d’installation de MySQLWorkbench

• Si vous utilisez Doctrine mysql-workbench-doctrine-plugin¹ fonctionne plutôt bien
• Si vous utilisez Propel mysql-workbench-propel-export-plugin² de générer le contenu de schema.xml, alors que SymfonyYamlMysqlWorkbenchPlugin³ vous permettra de générer le contenu de schema.yml

Dia

Si vous utilisez propel, il est possible de modéliser également votre schéma avec Dia grâce au plugin diaToPropelPlugin, en utilisant la boite à outil « Database » ça va sans dire.

Si vous utilisez Doctrine le plugin ConvertPropelSchemaToDoctrineSchema réalisera la conversion d’un schéma propel en schéma doctrine.

ArgoUML

En graltant un pei plus j’ai trouvé également le plugin uml2symfony, qui semble avoir l’ambition de traduire non pas un schéma de base de données, mais un schéma UML généré avec ArgoUML. Je vous laisse aller plus loin car j’ai personnellement trouvé l’idée séduisante mais la documentation très pauvre, voir inexistante!

Conclusion

Mon choix se portera sur le doublette gagnante MySQLWorkbench, mysql-workbench-doctrine-plugin car:

• DBDesigner n’est plus maintenu depuis belle lurette (je me rends compte en écrivant ce post que DBDesigner fork qui a dormi pendant prêt de 3 ans semble revenir à la vie depuis quelques jours)
• j’utilise maintenant Doctrine
• ce plugin permet une gestion fine des Behaviors Doctrine

C’est sans aucun doute le plus sexy de tous les environnements de développement PHP pour windows (wampserver2, successeur du défunt Wamp5, xampp , et easyPHP), en effet son interface de maintenance est riche et ergonomique

Elle permet notamment de passer d’une version à une autre de PHP en 1 clic, ce qui n’est pas négligeable.

Elle propose des interfaces de gestion simplifiées pour la configuration de PHP (extensions et variables du fichier  php.ini)

ainsi que pour celle d’apache (configuration de virtual hosts & modules apache)

Pour les barbus, les fichiers php.ini et httpd.conf sont toujours accessibles via un bouton, et il est même possible de paramétrer son éditeur de texte préféré (paths portables acceptés!) en cliquant sur le bouton « préférences ».

Dans la séries des raccourcis vous pourrez accéder en un clic

• à la page d’accueil de votre répertoire racine – http://localhost/
• au répertoire contenant les virtual hosts – z:\Apps\UwAmp\www\
• à phpMyAdmin – http://localhost/mysql/ (à noter que le mot de passe root de MySQL par défaut est root)
• à un phpinfo() – http://localhost/uwamp/phpinfo.php
• à SQLite Database Browser qui vous permettra de gérer vos bases de données SQLite

et en cadeau bonus

• Les logs access du serveur apache
• Les logs error du serveur apache
• Les logs du serveur MySQL
• à la suppression des fichiers de log sus cités
• à la suppression des fichiers de sessions PHP

…

Le petit bémol que je mettrais par rapport à l’installation de xampp portable, que j’ai déjà documentée, est que PEAR n’est pas préinstallé.

Pour utiliser les commandes PHP et mysql sans se préoccupper de leur path, suivez les explications suivantes en remplaçant ;\Apps\xampp\php\;\Apps\xampp\mysql\bin\ par  ;\Apps\UwAmp\apache\php_5.3.1;\Apps\UwAmpp\mysql\bin\. N’oubliez pas de fermer et de rouvrir votre session pour prendre en compte le nouveau Path (n’oubliez pas non plus de laisser un commentaire si vous avez une meilleure solution).

ouvrez ensuite un prompt de commande et tapez

cd z:\Apps\UwAmp\apache\php_5.31
go-pear.bat

si vous ne vous mettez pas dans le dossier  vous allez obtenir un message d’erreur du genre

Could not open input file: PEAR\go-pear.phar
Appuyez sur une touche pour continuer…

Sinon PEAR vous demandera si vous souhaitez faire une installation système ou locale. La différence réside essentiellement dans la localisation du fichier pear.ini. Si vous voulez comme moi jouer avec plusieurs installations de PEAR choisissez local. En effet l’installation système installe le fichier pear.ini dans c:\windows, ce qui le rendra commun à toutes  vos installations de PEAR. L’installation local permet de ranger le pear.ini dans le répertoire de la commande php auquel CETTE commande PEAR est associée …

Une fois le choix fait vous pouvez choisir les options par défaut lors du process d’installation

ensuite pour installer symfony 1.0

pear upgrade PEAR
pear channel-discover pear.symfony-project.com
pear install symfony/symfony-1.0.21
symfony -V

Vous êtes alors prêt pour askeet.

Pour installer la dernière version courante de symfony1.4.1

pear install symfony/symfony

Vous êtes alors prêt pour jobeet.

L'avantage c'est que vous disposez d'une installation de PEAR par version de PHP, ce qui est idéale pour avoir plusieurs version de symfony sur votre plateforme de développement!

Intégration de FCK

j’ai réécrit le template _commentForm.php pour y mettre un éditeur « riche » : FCKeditor (il doit bien entendu être configuré au préalable dans le /apps/myapp/config/settings.yml) en modifiant

<?php echo textarea_tag('sf_comment', '', array('cols' => 40, 'rows' => 8)) ?>

en

<?php echo textarea_tag('sf_comment', '', 'tool=Basic rich=fck size=40x8 disabled=false')?>

J’ai ensuite stocké le fichier modifié au niveau de l’appli /apps/myapp/modules/sfComment/templates/_commentForm.php afin de ne pas toucher au code du plugin

FCK se sent obligé de mettre une ligne vide en valeur par défaut ce qui fait que la directive required ne suffit pas, puisque ligne vide n’est pas vide.
J’ai donc réécrit la validation en tant qu’anonyme en y ajoutant

sf_comment:
  required:
    msg:           The message is required
  # blank from FCK
  sfCallbackValidator:
    callback:      strip_tags
    invalid_error: The message is required

J’ai stocké le fichier modifié au niveau de l’appli /apps/myapp/modules/sfComment/validate/anonymousComment.yml

Liens en nofollow

Mettre un lien en nofollow fait que ce lien n’est pas suivi par les moteurs de recherche, ce qui évite la transmission du PR … y en a que ça énerve d’ailleurs le nofollow
Pour commencer par supprimer l’intérêt de laisser un lien dans un commenatire, je me suis fait une fonction noFollow() dans /lib/myTools.php, qui prend en entrée du code html et réécrit en sortie tous les liens avec l’attribut rel= »nofollow ».

class myTools
{
  public static function noFollow ($str) {
    $str = stripslashes($str);
    $preg = "/<a href=\"(.*)\">(.*?)<\/a>/U";
    preg_match_all($preg, $str, $match);
    if(count($match[1]))
    {
        foreach ($match[1] as $key=>$val)
        {
            $pattern[] = '/'.preg_quote($match[0][$key],'/').'/';
            $replace[] = "<a href=\"".$val."\" rel=\"nofollow\">".$match[2][$key]."</a>";
        }
        return preg_replace($pattern, $replace, $str);
    }
    else
    {
       return $str;
    }
  }
}

J’ai ensuite réécrit l’affichage des commentaires en changeant ce passage à la fin de _commentView.php

<?php
  echo __('<span>%1%</span>, <a href="#sf_comment_%2%">%3%</a>',
    array(
      '%1%' => myTools::noFollow($author),
      '%2%' => $comment['Id'],
      '%3%' => $date
    )
  )
?>
<div>
  <?php echo myTools::noFollow($comment['Text']); ?>
</div>

En stockant ensuite ce fichier au niveau de mon application /apps/myapp/modules/sfComment/templates/_commentView.yml

Après ça je n’ai toujours pas réglé réellement le problème du spam … les bots des spamers ayant une approche pas très fine, ils ne prendront pas la peine de vérifier si leurs liens sont bien suivables par les moteurs de recherche dans les commentaires qu’ils ont laissés … en revanche ils vont repasser à intervalles réguliers ce qui est très désagréable!!

formulaire javascript

J’ai donc testé une des solutions js proposées sur cette page en remplacant les balise de formulaires dans /apps/myapp/modules/sfComment/templates/_commentForm.php par

...
<script language="JavaScript" type="text/javascript">
    document.write('<?echo form_tag('sfComment/'.$action, $options);?>');
</script>
...
<script language="JavaScript" type="text/javascript">
    document.write('</form>');
</script>
...

Naïf et rapide mais pas suffisant :-/

Captcha

Pour régler définitivement le problème j’ai mis en place sfCryptographpPlugin.
Comme la doc laisse un peu à désirer, voici une version traduite et adaptée de Howto do a Captcha in Symfony

installation

symfony plugin-install http://plugins.symfony-project.com/sfCaptchaPlugin

activer le module dans le settings.yml de l’application

all:
  .settings:
    enabled_modules: [default, sfCaptcha]

Personnellement je n’avais ni jpgraph_antispam-digits.class.php, ni jpgraph.class.php dans le répertoire lib/ du plugin je l’ai donc téléchargé ici https://trac.anl.gov/scavenger/browser/trunk/web/jpgraph/src/jpgraph_antispam-digits.php … en le sauvant dans lib/jpgraph_antispam-digits.class.php du plugin et changé:

require_once 'jpgraph_antispam.class.php';

en

require_once 'jpgraph_antispam-digits.class.php'

L’idée c’est que dans l’action qui doit afficher le captcha on le sauve (le captcha) dans une session pour ensuite l’afficher dans le tempate. J’ai donc ajouté le code suivant dans les actions qui affichent des posts de blog ou des pages. Vu que le captacha est sauvé session il sera forcément le même pour tous les posts lors d’un affichage par liste :-/

$g = new Captcha();
$this->getUser()->setAttribute('captcha', $g->generate());
<span style="font-family: verdana;">...</span>

il suffit maintenant d’afficher le captcha dans le template d’affichage de formulaire de commentaires que nous avons déjà modifié tout à l’heure, en ajoutant

<div class="required">
  <img src="<?php echo url_for('sfCaptcha/index'); ?>" alt="captcha" />
  &nbsp; &nbsp; &nbsp;
  <?php echo form_error('captcha'); ?>
  <?php echo input_tag('captcha',''); ?>
</div>

Il reste à modifier le validateur anonymousComment.yml en ajoutant le contrôle du captcha

captcha:
  required:
    msg: Please enter the numbers in the captcha image
  captchaValidator:
    error: Incorrect code

reste à effacer le cache du projet

symfony cc

et le captcha devrait fonctionner

Au passage un petit tips qui sert bien quand on joue avec les plugins dans symfony : How to fix a manually deleted plugin directory

optimiser la navigation multilingue et le référencement avec symfony en ne touchant pas aux urls des link_to existants, sachant que le site n’est que partiellement traduit, que l’internaute doit être notifié dans sa langue en cas de contenu non traduit, et que tous les objets du site ne sont pas forcément multilingues

référencement et internationalisation

Plusieurs paramètres permettent à Google de présager de la langue par défaut d’un site
1 – L’extension pays (.fr -> français, .it italien, etc …)
2 – Et en cas d’extension générique (.com, .org, .net, etc …) la géolocalisation de l’IP
Ce dernier point est à surveiller avec vigilance: un hébergeur comme http://1and1.fr qui possède une IP allemande est susceptible de vous attribuer une IP allemande pour un site a contenu exclusivement français … ce qui n’est pas conseillé par les tueurs du référencement qui m’ont fait la formation référencement naturelle
Le meilleur moyen de veiller au grain est encore d’installer FlagFox, une extension firefox indispensable qui affiche le drapeau du pays où est hébergé une page dans la barre d’url de votre navigateur (ainsi que beaucoup plus de détails via un simple clic sur le sus dit drapeau).

Bref une fois que la langue par défaut, le nom de domaine et éventuellement la géolocalisation sont en accord, il s’agit de gérer les autres langues disponibles de manière claire.
En gros j’ai retenu qu’il y avait deux écoles:
1 – Un sous domaine par langue comme dans ce post – symfonians en VF
2 – Un répertoire dans l’url par langue comme je vais l’exposer dans ce billet
D’après ce que j’ai compris on pourrait aussi faire figurer la langue dans le stripped_title des url réécrites par exemple

Pour toute la suite on travaille sur un site en .fr (donc google s’attend par défaut à du français), une application nommée back, et les trois langues gérées sont le français l’anglais et le chinois

N.B le stripped_title est généré via la fonction stripText suivante /lib/myTools.php

public static function stripText($text)
{
   $text = preg_replace('/\ +/', '-', $text);
   $text = preg_replace('/\-$/', '', $text);
   $text = preg_replace('/^\-/', '', $text);
   return $text;
}

faire apparaitre la culture dans l’url

il s’agit ici de ne pas utiliser la variable d’url sf_culture qui courcircuiterait la gestion de la culture et compliquerait pas mal les chose …
Je propose plutot une routing rule par culture /apps/back/config/routing.yml

sf_cms_content_fr:
  url:   /:stripped_title.html
  param: { module: sfCmsContent, action: show }
sf_cms_content_en:
  url:   /en/:stripped_title.html
  param: { module: sfCmsContent, action: show }
sf_cms_content_zh:
  url:   /zh/:stripped_title.html
param: { module: sfCmsContent, action: show }

les link_to s’écrivent alors comme suit

<?php link_to('link to content', '@sf_cms_content_'.$sfCmsContent->getCulture().'?stripped_title='.$sfCmsContent->getStrippedTitle());?>

L’idée est donc que l’on a ou non une langue par défaut qui ne fait pas l’objet d’un « préfixe culture » dans l’ur
On peut stocker la cultutre éventuelle par défaut dans /config/app.yml

lang:
  default: fr

navigation multilingue

le changement de culture se fait via une action associé à l’utilisateur /apps/back/modules/sfCmsUser/actions/actions.class.php

class sfCmsUserActions extends autosfCmsUserActions

{
   public function executeLanguage() {
      $this->getUser()->setCulture($this->getRequestParameter('culture'));
      $url = $this->getRequest()->getReferer() != '' ? $this->getRequest()->getReferer() : '@homepage';
      $this->redirect($url);
   }
}

L’affichage des drapeaux se fait comme suit /apps/back/modules/sfCmsLang/tmeplates/_default.php

<?php if( count( sfConfig::get('app_lang_back') ) > 1):?>
   <?php foreach(sfConfig::get('app_lang_back') AS $lg => $lang):?>
      <?php if($lg==$sf_user->getCulture()):?>
         <?php echo image_tag('lang/'.$lg.'_shadow',array('alt'=> $lang, 'title'=>$lang))?>
      <?php else:?>
         <?php echo link_to(image_tag('lang/'.$lg,array('alt'=> $lang, 'title'=>$lang)), 'sfCmsUser/language?culture='.$lg)?>
      <?php endif?>
   <?php endforeach?>
<?php endif?>

Notez la soumission par méthode get qui permet aux moteur de recherche d’indexer le contenu multilingue
Enfin j’ai retouché la classe SfCmsContent comme suit dans /lib/model/SfCmsContent.php

class SfCmsContent extends BaseSfCmsContent
{
  public function hydrate(ResultSet $rs, $startcol = 1)
  {
    parent::hydrate($rs, $startcol);
    $this->setCulture(sfContext::getInstance()->getUser()->getCulture());
    $lang = array_keys(sfConfig::get('app_lang_'.sfConfig::get('sf_app')));
    $lg = array_pop($lang);
    while($this->getTitle()=='' && $lg )
    {
      $this->setCulture($lg);
      $lg = array_pop($lang);
    }
  }

  public function isTranslated($lg)
  {
    $c = new Criteria();
    $c->add(SfCmsContentI18nPeer::CULTURE, $lg);
    $c->addAnd(SfCmsContentI18nPeer::SF_CMS_CONTENT_ID, $this->getId());
    $sfCmsContentI18n = SfCmsContentI18nPeer::doSelectOne($c);
    if($sfCmsContentI18n && $sfCmsContentI18n->getTitle() && $sfCmsContentI18n->getStrippedTitle())
    {
      return $sfCmsContentI18n;
    }
    else
    {
      return false;
    }
  }
}

La réécriture de la méthode hydrate permet d’avoir l’objet sfCmsContent dans la culture la plus adaptée à celle de l’internaute (notez que l’ordre des cultures à un sens)
La méthode isTranslated permet de connaître la disponibilité d’un objet sfCmsContent pour une culture …

gérer la cohérence de la langue dans l’url / éviter le duplicate content

Maintenant le problème est de gérer la cohérence des urls, en utilisant correctement les routing rules énoncées plus haut, il y a une bonne partie du travail de fait … le seul problème qui se pose est celui de la culture par défaut qui n’a pas de préfixe. La conséquence est que les urls des cultures autres que par défaut répondent sur toute leur routing rule … et même sion a bien soigné la génération des liens en amont, mieux vaut se préserver du duplicate content et éviter les blagues. Voici donc un validateur pour l’action show qui va vérifier

• que l’url contient bien un stripped_title et non pas un simple identifiant
• la disponibilité du contenu dans la culture de l’utilisateur (en le notifiant si le contenu n’est pas disponible)
• la cohérence entre la culture du stripped_title du contenu et celle de l’utilisateur
• la cohérence entre la culture du préfixe et celle du stripped_title

public function validateShow()
{

  // l'url contient bien un stripped_title et non pas un simple identifiant
  if($this->getRequestParameter('id'))
  {
    $sfCmsContent = SfCmsContentPeer::retrieveByPk($this->getRequestParameter('id'));
    $this->redirect('@sf_cms_content_'.$this->getUser()->getCulture().'?stripped_title='.$sfCmsContent->getStrippedTitle());
  }
  elseif($this->getRequestParameter('stripped_title'))
  {
    $sfCmsContent = SfCmsContentPeer::retrieveByStrippedTitle($this->getRequestParameter('stripped_title'));
    if($this->getUser()->can($sfCmsContent, 'show'))
    {
      $c = new Criteria();
      $c->add(SfCmsContentI18nPeer::STRIPPED_TITLE, $this->getRequestParameter('stripped_title'));
      $sfCmsContentI18nFromStrippedTitle = SfCmsContentI18nPeer::doSelectOne($c);

      // disponibilité du contenu dans la culture de l'utilisateur (en le notifiant si le contenu n'est pas disponible)
      if($sfCmsContent->isTranslated($this->getUser()->getCulture()))
      {
        $this->getUser()->setAttribute('translation_missing', false);
      }
      else
      {
        $this->getUser()->setAttribute('translation_missing', true);
      }

      // cohérence entre la culture du stripped_title du contenu et celle de l'utilisateur
      if($sfCmsContentI18nFromStrippedTitle->getCulture()!=$this->getUser()->getCulture())
      {
        if($sfCmsContent->isTranslated($this->getUser()->getCulture()))
      	 {
      	   $c = new Criteria();
      	   $c->add(SfCmsContentI18nPeer::SF_CMS_CONTENT_ID, $sfCmsContentI18nFromStrippedTitle->getSfCmsContentId());
      	   $c->addAnd(SfCmsContentI18nPeer::CULTURE, $this->getUser()->getCulture());
      	   $sfCmsContentUserCulture = SfCmsContentI18nPeer::doSelectOne($c);
      	   $this->redirect('@sf_cms_content_'.$this->getUser()->getCulture().'?stripped_title='.$sfCmsContentUserCulture->getStrippedTitle());
      	  }
       }
       // cohérence entre la culture du préfixe et celle du stripped_title
      	$uri = split('/',$this->getRequest()->getPathinfo());
    	if(strlen($uri[1])==2)
    	{
	  $uri_language = $uri[1];
    	}
    	elseif(sfConfig::get('app_lang_default'))
    	{
	  $uri_language = sfConfig::get('app_lang_default');
    	}
    	if(sfConfig::has('app_lang_default') && $uri_language != $sfCmsContentI18nFromStrippedTitle->getCulture())
    	{
	  $this->redirect('@sf_cms_content_'.$sfCmsContentI18nFromStrippedTitle->getCulture().'?stripped_title='.$sfCmsContentI18nFromStrippedTitle->getStrippedTitle());
    	}
     }
     return true;
   }
   else
   {
     $this->forward404();
   }
 }
}

Comme on a pris soin de mettre une notification si le contenu n’est pas disponible dans la culture souhaité, il ne reste plus qu’à l’afficher, avec un petit effet scriptaculous histoire d’attirer l’attention de l’internaute
/apps/back/modules/sfCmsContent/templates/showSuccess.php

<?php if($sf_user->getAttribute('translation_missing')):?>
   <p id="missing_translation">
      <?php echo __('The content you are looking for is missing for your language')?>
   </p>
   <?php echo javascript_tag(
      visual_effect('highlight', 'missing_translation',
         array(
            'duration' => 2
         )
      )
   )?>
<?php endif?>
<?php echo $sfCmsContent->getHtmlBody();?>

N.B pour chaque nouvel objet multilingue il faudra

• ajouter une routing rules par culture
• réécrire les méthode hydrate et isTranslated
• adapter le validateur validateShow
• modififer le template pour faire apparaître la notification

<?php class sfGooglebotNotifierFilter extends sfFilter
{
   public function execute($filterChain)
   {
      if (preg_match('#Googlebot#i', $this->getContext()->getRequest()->getHttpHeader('User-Agent')))
      {
         $mail = new sfMail();
         $mail->initialize();
         $mail->setMailer('sendmail');
         $mail->setCharset('utf-8');
         $mail->setSender('mailer@monsite.com', 'mailer de monsite.com');
         $mail->setFrom('mailer@monsite.com', 'mailer de monsite.com');
         $mail->addAddress('your@mail.com');
         $mail->setSubject('Google bot visit');
         $mail->setBody($this->getContext()->getRequest()->getHttpHeader('User-Agent').' has visited '.$this->getContext()->getRequest()->getUri());
         $mail->send();
      }
      $filterChain->execute();
   }
}
 ?>

N.B. Les passages du googlebots sont aussi disponibles dans les rapports de Googel Analytics ( visiteurs, capacités du navigateur, navigateurs).
à intégrer comme suit dans /apps/myapp/config/filters.yml

rendering: ~
web_debug: ~
sf_googlebot_notifier:
  class: sfGooglebotNotifierFilter
security:  ~
# generally, you will want to insert your own filters here
cache:     ~
common:    ~
flash:     ~
execution: ~

J’allais oublier un gand merci au même William Durand pour son autre post SyntaxHighlighter, TinyMCE et YML, qui m’a permis d’intégrer la coloration syntaxique YAML à syntaxHighlighter2 via la brush qu’il a conçue

autre ressource: http://alexgorbatchev.com/wiki/SyntaxHighlighter:Brushes:Custom

C’est pourquoi il est maintenant possible de connaître la popularité d’un plugin symfony avant de l’intégrer à son projet

La liste de mes préférés:

• sfLucenePlugin
• sfPropelActAsTaggableBehaviorPlugin
• sfPropelActAsRatableBehaviorPlugin
• sfThumbnailPlugin
• sfTagtoolsPlugin
• sfFeed2Plugin
• sfPropelActAsCommentableBehaviorPlugin
• sfPropelVersionableBehaviorPlugin
• sfSimpleForumPlugin

N.B. ce sont mes plugins préférés pour symfony 1.0 … je ne désepère pas de trouver 24h00 pour me fader jobeet et passer à la 1.2:-/

Il se trouve que là ça partait mal parce que science po est plutôt orienté JQuery et moi plutôt prototype (distribué en natif avec symfony) … par expérience, les deux librairies ne sont pas compatibles, et en plus je n’ai pas l’intention de faire charger deux librairies JS à mes clients: quesiton d’éthique!

Primo en googlant j’affine un peu ce que je veux : un menu accordeon écrit avec la librairie prototype.
Une fois formulée ça fait pas un pli, je tombe sur ce tuto, qui paraît pil poil répondre à mes besoins: Create a Simple, Intelligent Accordion Effect Using Prototype and Scriptaculous.

Le net c’est génial me dis je, en essayant de faire fonctionner ce tuto dans mon projet symfony. Il se trouve que les librairies prototype sont automatiquement chargées à chaque page de mon projet puisque mon moteur de recherche, inclus dans toutes les pages, utilise l’auto-complétion et que cette dernière est gérée par des helpers ajax …
Donc je n’ai qu’à inclure le script du tuto, parmis mes js et le tour est joué.
Oui mais il faut que le js du menu soit inclus après les librairires prototypes (en JS en tout cas il n’y a pas le choix). Soit, j’ai déjà eu à gérer l’ordonnancement de mes CSS via le fichier view.yml :

stylesheets:    [main, menu, back: { position: last }]

je tente la même chose avec mon javascript

javascripts:     [menu: { position: last }]

Mais là c’est la déception, ça ne fonctionne pas du tout, il n’y a pas de moyen propre d’ordonnancer l’inclusion de ces JS dans symfony (1.0 en tout cas!)
Re-googling et c’est ruzz qui me donne un bon tuyau. J’adapte le tout en passant par un filtre sfCmsCustomJs.php

class sfCmsCustomJs extends sfFilter
{
    public function execute($filterChain)
    {
           if($this->isFirstCall())
           {

              sfContext::getInstance()->getResponse()->setParameter(sfConfig::get('sf_prototype_web_dir').'/js/effects.js',sfConfig::get('sf_prototype_web_dir').'/js/effects.js','helper/asset/auto/javascript');
              sfContext::getInstance()->getResponse()->setParameter('menu.js','menu.js','helper/asset/auto/javascript');
              // ajout de javascript conditionné par PHP dans l'entête
             $CustomDynamicJs = "
                ";

             $response = $this->getContext()->getResponse();
             $response->setContent(str_ireplace('', $CustomDynamicJs.'',$response->getContent()));
           }
     }
}

C’est pas ce que j’ai fait de plus élégant, mais ça a le mérite de (bien fonctionner) et de permettre d’ajouter simplement du JS conditioné par PHP.

Bref je trouvais déjà que ça faisait beaucoup pour un simple menu jusqu’à ce que je constate que ce menu ne marche pas .
Mieux je constate qu’il est écrit en prototype 1.6.0 et que mon install de symfony (1.0.19) embarque la version 1.5.0 …
Fin du fin les deux versions n’ont pas l’air super compatibles.

Donc Re-Re-Googling : pour un amenu accordéon écrit avec prototype 1.5.0.
J’ai donc fini par opter pour ce menu en accordéon qui fait, une fois adapté ce qui n’est pas rien, très bien l’affaire.
Un big Up pour Kevin Miller qui rêve d’un mac book pro … n’hésitez pas

sfPropelActAsTaggablePlugin doit être installé. Ce plugin offre des fonctionnalités additionnelles qui utilisent ce plugin. Il n’ya pas moyen de les utiliser sans ce plugin.

Pour utiliser la page d’administration et les fonctionnalités de recherche incrémental, vous devez avoir prototype (prototype.js) charger dans vos pages.

Introduction

Ce plugin offre plusieurs fonctionnalités additionnelles autour des fonctionnalités standards déjà offeretes par l’excellent sfPropelActAsTaggablePlugin. Ce plugin est moins mature que sfPropelActAsTaggablePlugin mais offre un peu de matière pour développer une interface utilisateur

Contact

sfTagtoolsPlugin a été créé par l’équipe [http://www.punkave.com/ P'unk Avenue]. Veuillez adresse les questions, inquiétudes et patchs à [mailto:tom@punkave.com Tom Boutell].

Fonctionnalités

• recherche inccrémental pour les tags, avec auto complétion sur validation clavier ou clic de souris. Similaires aux solutions flickr, avec lesquels beaucoup d’utilisateurs cont déjà familier. Voir: lib/helper/tagaheadHelper.php
• Le concept de tags mis « en valeur ». C’est juste une manière pratique de mettre certains tags en valeur pour les besoisn de votre propre interface utilisateur Si un tag possède un objet !FeatureTag associé, vous savez que c’est un tag mis en valeur. Nous offrons cette possibilité de « mise en valeur » dans …
• Une page d’administration ajaxifiée pour renommer, fusionner, supprimer, prioriser et mettre en valeur les tags. Notez que vous ne devez pas forcément d’utiliser les !FeaturedTag dans la page d’administration, c’est une fonctionnalité optionnelle.
• Le concept de tags priorisés, implémté par la classe !PriorityTag. Un tag avec une priorité haute apparaîtra en premier dans les résultats retournés par sfTagtoolsToolkit::getBeginningWith(). Une fois de plus cette fonctionnalité est optionnelle, vous pouvez utiliser la recherche incrémental et la page d’administration sans !PriorityTag. « Mais qu’est ce donc que sfTagtoolsToolkit::getBeginningWith()? » vous demandez vous. Cela nous donne:
• Une façon de retrouver les tags classés par ordre de popularité, et de les restreindre éventuellement à ceux commençant par une chaîne de caractère donnée. Voir sfTagtoolsToolkit::getBeginningWith(). Cette méthode a vu le jour en tant que partie de la recherche incrémentale mais, avec une chaîne de caractère vide comme début, est pratique pour créer des tags aussi
• Une façon d’itérer sur les objets d’un modèle taggable en particulier qui seraient liés à un ensemble défini de tags, de les classer par ordre descendant de tag associé, avec la notion de priorité des tags permet une possibiolité de c lassement supplémentaire.

Philosophie

sfPropelActAsTaggablePlugin tiens sa magie du fait qu’il trie les nom des classes d’objets taggés comme une chaîne de caractère en base de données (taggable_model). C’est très bien dans la plupart des cas mais cela pose des problèmes quand il s’agit de classé les choses de manière sémantique et que les taggages éventés qui pointent vers des objets morts ne sont pas pris en compte. Cela pourrait être vu en tant qu’ extension pour une clause SQL IN (utilisé par la méthode de retrieveByPKs des classes peer classes Propel), et le code de Xavier Lacot’s fait un usage héroïque de cette fonctionnalité. De toute façon ces considérations ont tendance à devenir moins importante, disons le, il s’agit de compter rapidement les objets taggés d’un modèle en particullier sans avoir les coûts liés aux méthodes d’hydratation (pour la construction d’une page d’administration par exemple). Cela devient moins important également si vous avez des centaines de milliers d’enregistrement, créés dans des clauses IN trop grande pour un paquet MySQL (qui ne fonctionne pas de toute façon). C’est vrai qu’un identifiant est plus léger qu’un objet entier, mais quand vous en avez assez c’est encore mauvais.

Donc si vous voulez compter les objets taggés d’un modèle en particulier qui exist encore et qui réponde à un critère de « vie » ou de « publication » sans les hydrater … bienvenue dans le monde de la requête SQL personnalisée! heureusement j’ai codé ces requêtes pour vous!
Là aussi vous pouvez ne pas l’utiliser, sfTagtoolsPlugin fonctionne mieus quand vous décrivez vos classes taggables via app.yml. Cela permet à sfTagtoolsPlugin de palier à son design limiter de sfPropelActAsTaggablePlugin en joignant les tables contenant les classes quand une requête personnalisée ne cherche qu’à récupérer les informations souhaitées.

« Est que ce n’est pas encore un peu lent? » il y a encore une petite perte de performance sur les tags et le taggage seuls, mais ce n’est pas signifiant en terme de « big-O notation » (au moins pas si mYSQL fait son travaille et qu’il optimise correctement les requêtes). Enfin, si vous avez un zillion de classes taggable, vous devriez plutôt avoir une seule classe taggable, et la peupler à partir des tables des vrais objets. Sigh… Ce serait opas génial si Propel comprenait l’héritage multiple

Installation

Installez le plugin. Okay, ce n’est pas si simple que ça.

vous devez activer le module tagtools dans votre application. dans mon apps/frontend/config/settings.yml, J’ai:

# Activated modules from plugins or from the symfony core
enabled_modules:        [default, sfGuardAuth, sfGuardUser, sfGuardGroup, sfGuardPermission, tagtools]

Vote liste de modules peut bien entendu varier, assurez vous simplement d’avoir tagtools ajouter à la liste des enabled_modules dans votre configuration.

Vous devrez aussi avoir prototype dans vos pages. dans la section default de votre apps/frontend/config/view.yml, vous pouvez utiliser:

javascripts:    [%SF_PROTOTYPE_WEB_DIR%/js/prototype]

Pour utiliser la recherche incrémental, vous aurez aussi besoin de tagahead.js:

javascripts:    [%SF_PROTOTYPE_WEB_DIR%/js/prototype, %SF_WEB_ROOT%/tagtools/js/tagahead.js]

Votre site dervait utiliser d’autres librairies javascript qui devrait être chargées via une liste séparée par des virgules.

Enfin pour que la recherche incrémentale (« tagahead ») fonctionne bien, vous devez avoir un minimum de configuraiton CSS pour un affichage correct des tags suggérés. Voir sfTagtoolsPlugin/web/css/suggested.css pour plus de détails.

C’est tout pour l’essentiel de la configuration. Mais pour tirer pleinement parti du plugin, vous devriez décrire vos classes taggables dans votre app.yml. Et vous devirez vouloir activer le support optionnel des !FeaturedTag et !PriorityTag, bien que le plugin fonctionne bien sans. Voici un exemple:

all:
  sfTagtoolsPlugin:
    featured: true
    priority: true
    taggables:
      - name: Release
        label: Releases
        cssclass: releases
      - name: PressKit
        label: Presskits
        cssclass: presskits
      - name: Media
        label: Media
        cssclass: media
    criteria_live: "TAGGABLE.live = true"
    criteria_public: "TAGGABLE.published = true"

« Que sont criteria_live et criteria_public? » Ces critère sont appliqués pour décider si l’objet taggé fait référence à un objet en vie. So votre application, comme la pluaprt des notres, implique des objets que l’utilisateur abandonne en cours de création, alors vous voyez de quoi je parle. le critère criteria_public est identique, Mais il est appliqué seulement si l’utilisateur est connecté (isAuthenticated a échoué sur le sfUser courant). le mot TAGGABLE est automatiquement rempalcé par le nom de la table associée à l’objet quand la requête est lancée.

« Que sont label et cssclass? » Elles sont utilisés pour la page d’administration, elles sont donc otpionnelles si vous n’utilisez pas la page d’administration. Vous aurez besoin du nom de du champs, qui doit être un nom de classe PHP (pas un nom de table) pour ce type d’objet.

« Puis je utiliser la recherche incrémentale sans aucunes de ces configurations? » Oui, mais sfTagtools ne sera pas en mesure de distinguer les liens vers des objets morts des liens vers des objets vivants. Donc je recommande fortement que vous définissiez au moins vos modèles taggables.

sfTagtoolsPlugin:
  taggables:
    - name: Release
      label: Releases
      cssclass: releases
    - name: PressKit
      label: Presskits
      cssclass: presskits
    - name: Media
      label: Media
      cssclass: media

Autrement vous verrez dans les suggestions de la recherche incrémentale des tags qui n’ont plus lieu d’être, peut être pour une raison valable. Vous verrez aussi un compte gonflé des occurences total pour chaque tag dans le module d’amdinistration, parce que les taggages ne sont jamais supprimés et que sfTagtools n’a pas assez d’informations pour faire la jointure avec les modèles taggables et compter seulement les taggages qui ont de l’importance.

n’oubliez pas de vider le cache de votre applicaiton « symfony cc »!

Implementer la recherche incrémentale

Pour implémenter la recherche incrémentale, utiliser un code comme le suivant:

<?php use_helper("tagahead") ?>
<div>
<label for="tags">Tags</label>
<?php echo tagahead_input_tag("tags", $tags) ?>
</div>
<div>
<label for="tags-suggestions">Suggested Tags</label>
<div id="tags-suggestions"></div>
</div>
<?php echo tagahead_observer('tags') ?>

le helper tagahead_input_tag génère une balise input avec le nom spécifié (qui sera aussi son ID). Le helper tagahead_observer génère un code Javascript pour mettre à jour dynamiquement la liste des tags suggérés basée sur ce que l’utilisateur a déjà tapé..

Implemener la page d’amdinistration

La page de ‘administration des tags a été activée en meêm tant que le module des tags. Elle est aussi sécurisée avec un règle sfTagtoolsPlugin/modules/tagtools/config/security.yml. Cette règle empçeche simplement les utilisateurs d’accéder à cette page s’ils ne sont pas authentifiés. Si votre site possède plusieurs niveau de permissions, vous n’aurrez qu’à ajuster cette configuration pour que seul les administrateurs puissent supprimer, renommer et fucionner les tags!

Pour accéder à la page d’administration, visitez simplement:

http://yoursite/tagtools/admin

Une fois de plus, vous devez être authentifié si vous utilisez le security.yml livré avec le plugin.

la classe met à disposition une couche d’abstraction pour la librarie TCPDF. L’intérêt principal de cette extension de FPDF réside dans le fait que l’on peut manipuler n’importe quelle chaîne de carctères en UTF-8.

Installation

• Installer le plugin

  symfony plugin-install http://plugins.symfony-project.com/sfTCPDFPlugin

  ou téléchargez le package et décompresser le dans le répertoire /plugins

• téléchargez la librarie TCPDF
• Décompressez là dans le répertoire /plugins/sfTCPDFplugin/lib

A ce niveau là vous devriez avoir un répertoire tcpdf dans /plugins/sfTCPDFPlugin/lib

• copiez les fichiers de /web/ directement dans le répertoire /web de votre application
• supprimez le cache

  symfony cc

Configuration

• initialisez correctement sf_tcpdf_dir dans le config.php de votre application si la librairie TCPDF n’est pas dans le répertoire /plugins/sfTCPDFplugin/lib (vérifiez /plugins/sfTCPDFPlugin/config/config.php)
• Si vous voulez des paramètres distincts pour chaque PDF généré vérifiez /plugins/sfTCPDFPlugin/config/config.php et tcpdf/config/tcpdf_config.php.
• Si vous voulez tester, activez le module sfTCPDF dans votre fichier settings.yml, et ensuite appelez l’url sfTCPDF/test ou sfTCPDF/test2

Usage

//Hello World test (sfTCPDF/test)
public function executeTest() {
  // pdf object
  $pdf = new sfTCPDF();
  // settings
  $pdf->SetFont("FreeSerif", "", 12);
  $pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT);
  $pdf->setHeaderFont(array(PDF_FONT_NAME_MAIN, *, PDF_FONT_SIZE_MAIN));
  $pdf->SetHeaderData(PDF_HEADER_LOGO, PDF_HEADER_LOGO_WIDTH, PDF_HEADER_TITLE, PDF_HEADER_STRING);
  $pdf->setFooterFont(array(PDF_FONT_NAME_DATA, *, PDF_FONT_SIZE_DATA)); $pdf->SetHeaderMargin(PDF_MARGIN_HEADER);
  $pdf->SetFooterMargin(PDF_MARGIN_FOOTER);
  // init pdf doc
  $pdf->AliasNbPages();
  $pdf->AddPage();
  $pdf->Cell(80, 10, "Hello World !!! & é € U û ???");
  // output
  $pdf->Output();
  return sfView::NONE;
}