Dator Blog

Dans cet épisode, nous allons intégrer le design de notre application et nous allons aborder des routes assez pratique pour une application multilingue.

Plan de l’épisode #07

• Création des pages HTML et des fichiers CSS.
• Préparations des routes.
• Les routes et l’internationalisation.
• Conclusion

Création des pages HTML et des fichiers CSS.

Pour vous simplifier la tache, nous avons déjà découpé les éléments dont nous allons avoir besoin pour intégrer notre design. Vous pouvez donc télécharger le zip directement sur ce lien.

Toutes ces images vont donc nous conduire à un design ressemblant à celui-ci :

Le contenu de ce dossier sera a copier dans le répertoire /public/img/design/.
Nous allons maintenant intégrer notre design pour notre application.

Commençons par la base, la structure HTML:

<div id="conteneur">
  <div id="top"></div>
  <div id="header"></div>
  <div id="centre"></div>
  <div id="footer"></div>
</div>

Dans notre div top, nous allons placer un lien pour revenir sur l’index de notre page.

<div id="top">
  <a href="" class='logo_wmd'>
    <img src="/img/design/logo.png" alt="Watch My Desk - Show Off your Geekstation" title="Watch My Desk - Show Off your Geekstation" />
  </a>
</div>

Dans cette div, nous allons aussi ajouter notre menu :

<div id="top">
  <a href="" class='logo_wmd'>
    <img src="/images/design/logo.png" alt="Watch My Desk - Show Off your Geekstation" title="Watch My Desk - Show Off your Geekstation" />
  </a>
  <p class="boutons_top">
    <a href="" class="bouton">Browse</a>
    <a href="" class="bouton">Join Now</a>
    <a href="" class="bouton">Login</a>
    <a href="" class="bouton">Your desk</a>
  </p>
</div>

Les liens seront remplit à la suite de ce tutoriel car il nous faudra définir les bonnes routes pour notre application.

Maintenant nous allons passer à la div header :

<div id="header">
	<div class="title_head">
	   <h1>Show Off your geekstation.</span></h1>
	   <p>Watch My Desk is a website where you can share, browse and rate pictures of desks and computers of the world.</p>
	</div>
	<div class="join_now">
		<p>Join the website to share your desk or post comments, just in 2 clics !</p>
		<a href=""></a>
	</div>
</div>

Concernant la div centre, elle sera remplie dynamiquement. Il nous suffit donc d’appeler la bonne méthode :

< ?php echo $this->layout()->content ?>

Le footer sera abordé dans un prochain épisode .

Et pour finir, nous allons ajouter le CSS à notre application ! Pour cela, rendez-vous dans le fichier /public/css/main.css.

Je vous donne le CSS directement sans réel explication, vous pourrez les trouver sur la Ferme Du Web (ça évitera le duplicate-content !)

* {
	margin: 0;
	padding: 0;
}
body {
	font-family: Arial, Helvetica, sans-serif;
	font-size: 12px;
	color: #000000;
}
a img {
	border: none;
}

#conteneur {
	margin: 0 auto;
	overflow: hidden;
	width: 960px;
}

#conteneur #top {
	height: 40px;
	width: 100%;
	overflow: hidden;
	background-image: url("/img/design/back_top.png");
	background-repeat: repeat-x;
}

#conteneur #header {
	height: 190px;
	width: 100%;
	overflow: hidden;
	background-image: url("/img/design/back_header.png");
	background-repeat: repeat-x;
}
#conteneur #centre {
	overflow: hidden;
}
#conteneur #footer {
	height: 142px;
	width: 100%;
	overflow: hidden;
	background-image: url("/img/design/back_footer.png");
	background-repeat: repeat-x;
}

#conteneur #header .title_head {
	float: left;
}
#conteneur #header .title_head h1 {
	color: #2c4f56;
	font-size: 40px;
	font-weight: bold;
	line-height: 35px;
	margin: 30px 0 15px 80px;
	text-shadow: 1px 1px 1px #FFF;
}
#conteneur #header .title_head h1 span {
	font-size: 50px;
	font-style: italic;
	display: block;
	margin-left: 40px;
}
#conteneur #header .title_head p {
	color: #444444;
	margin: 20px 0 0px 80px;
	width: 450px;
}
#conteneur #header div.join_now {
	float: right;
	width: 205px;
	margin: 30px 80px 0 0;
	padding: 20px;
	text-align: center;
	background: #FFF;
	border: 1px solid #c0c0c0;
	-moz-border-radius: 20px;
	-webkit-border-radius: 20px;
}
#conteneur #top .logo_wmd {
	float: left;
	margin-left: 10px;
}

#conteneur #top .boutons_top {
	float: right;
	height: 40px;
	margin-right: 20px;
	margin-top: 9px;
}
#conteneur #top .boutons_top a.bouton {
	display: block;
	background-image: url("/img/design/back_bouton.png");
	background-repeat: no-repeat;
	color: #FFF;
	width: 72px;
	height: 19px;
	line-height: 19px;
	float: left;
	text-align: center;
	margin-right: 15px;
	text-decoration: none;
}

#conteneur #top .boutons_top a.bouton:hover {
	background-image: url("/img/design/back_bouton2.png");
}

Préparations des routes.

Il nous faut maintenant ajouter les liens dans notre layout pour avoir accès aux différentes pages de notre application. Pour cela, nous allons utiliser le helper que le Zend Framework nous fournit : le helper Url.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<?php echo $this->headTitle() ?>
<?php echo $this->headScript() ?>
<link rel="stylesheet" href="/css/main.css" type="text/css" media="screen, projection" />
<?php echo $this->headStyle() ?>
<link rel="shortcut icon" href="favicon.ico" />
</head>
<body>
	<div id="conteneur">
		<div id="top">
			<a href="<?php echo $this->url(array('language' => $this->language), 'localized_homepage') ?>" class="logo_wmd">
				<img src="/img/design/logo.png" alt="Watch My Desk - Show Off your Geekstation" title="Watch My Desk - Show Off your Geekstation" />
			</a>
			<p class="boutons_top">
				<a href="<?php echo $this->url(array('language' => $this->language), 'browse') ?>" class="bouton">Browse</a>
				<a href="<?php echo $this->url(array('language' => $this->language), 'register') ?>" class="bouton">Join Now</a>
				<a href="<?php echo $this->url(array('language' => $this->language), 'login') ?>" class="bouton">Login</a>
				<a href="<?php echo $this->url(array('language' => $this->language), 'share') ?>" class="bouton">Your Desk</a>
			</p>
		</div>
		<div id="header">
			<div class="title_head">
				<h1>Show off <span>your geekstation.</span></h1>
				<p>Watch My Desk is a website where you can share, browse and rate pictures of desks and computers of the world.</p>
			</div>
			<div class="join_now">
				<p>Join the website to share your desk or post comments, just in 2 clics !</p>
				<a href="< ?php echo $this->url(array('language' => $this->language), 'register') ?>">
					<img src="/img/design/join_now_fr.png" alt="Join now and show off your desk with the community !" title="Join now and show off your desk with the community !" /></a>
			</div>
		</div>
		<div id="centre"><?php echo $this->layout()->content ?></div>
		<div id="footer"></div>
	</div>
</body>
</html>

Comme ça de base, notre application ne marchera pas, il nous manque deux choses, le plugin de traduction, et les routes.

Tout d’abords, mettons en place notre plugin de traduction. Rendez-vous dans le dossier applications/plugins et créez un fichier nommé Translate.php avec comme contenu :

< ?php
class Plugin_Translate extends  Zend_Controller_Plugin_Abstract {

  protected $_view;

  public function __construct($view){
    $this->_view = $view;
  }
  public function routeShutdown($view) {
    // on récupère le paramètre de la langue dans l'url
    $locale = $this->getRequest()->getParam('language');
    // On lance notre Translate (avec les différents fichiers).
    $translate = new Zend_Translate('array',APPLICATION_PATH.'/languages/fr_FR.php','fr');
    $translate->addTranslation(APPLICATION_PATH.'/languages/en_US.php','en');
    // On stoque notre locale (fr ou en) dans notre registre.
    Zend_Registry::set('Zend_Locale', $locale);

    // si la langue demandé ne possède pas de traduction
    if (!$translate->isAvailable($locale)) {
         // on change la langue par defaut (en) dans notre traduction.
        $translate->setLocale('en');
         // et on ajoute à la variable de vue la langue 'en'
        $this->_view->language = 'en';
    } else {
        $translate->setLocale($locale);
        $this->_view->language = Zend_Registry::get('Zend_Locale');
    }

    Zend_Registry::set('Zend_Translate', $translate);

  }
}

Si jamais vous avez une autre solution pour ce genre de traduction, n’hésitez pas à me le faire savoir dans les commentaires.

Ensuite direction notre Bootstrap.php. Nous allons supprimer la méthode _initTranslate pour la remplasser par une qui convient mieux à notre application.

protected function _initTranslatePlugin() {
    $this->bootstrap('view');
    $this->bootstrap('frontController');
    $front = $this->getResource('frontController');
    $view = $this->getResource('view');
    $front->registerPlugin(new Plugin_Translate($view));
}

De cette façon, notre plugin de traduction est lancé à chaque appelle de page, pas mal non ? Et on garde un contrôle totale sur notre traduction.

Toujours dans ce fichier, vous allez supprimer notre ancienne méthode _initRoutes et créer une méthode _initRouter comme cela :

protected function _initRouter(){
    $this->bootstrap('frontController');
    $front = $this->getResource('frontController');
    $router = $front->getRouter();
    $router->addConfig(new Zend_Config_Ini(APPLICATION_PATH . '/configs/routes.ini', 'routes'), 'routes');
    return $router;
}

Comme vous pouvez le voir, nous ajoutons un fichier de configuration à notre application, dans notre cas il s’agit des différentes routes.

Nous allons donc créer un fichier /configs/routes.ini et le remplir de cette façon :

[routes]
routes.register.type = "Zend_Controller_Router_Route"
routes.register.route = ":language/register"
routes.register.defaults.module = frontend
routes.register.defaults.controller = membre
routes.register.defaults.action = new
routes.register.defaults.language = en

routes.browse.type = "Zend_Controller_Router_Route"
routes.browse.route = ":language/workstations"
routes.browse.defaults.module = frontend
routes.browse.defaults.controller = bureau
routes.browse.defaults.action = list
routes.browse.defaults.language = en

routes.login.type = "Zend_Controller_Router_Route"
routes.login.route = ":language/login"
routes.login.defaults.module = frontend
routes.login.defaults.controller = membre
routes.login.defaults.action = login
routes.login.defaults.language = en

routes.share.type = "Zend_Controller_Router_Route"
routes.share.route = ":language/share"
routes.share.defaults.module = frontend
routes.share.defaults.controller = bureau
routes.share.defaults.action = new
routes.share.defaults.language = en

routes.change_language.type = "Zend_Controller_Router_Route"
routes.change_language.route = "change_language"
routes.change_language.defaults.module = frontend
routes.change_language.defaults.controller = language
routes.change_language.defaults.action = changeLanguage
routes.change_language.defaults.language = en

routes.localized_homepage.type = "Zend_Controller_Router_Route"
routes.localized_homepage.route = ":language/"
routes.localized_homepage.defaults.module = frontend
routes.localized_homepage.defaults.controller = index
routes.localized_homepage.defaults.action = index
routes.localized_homepage.defaults.language = en

Je pense pas que cela demande beaucoup d’explications, tout est assez explicite. Néanmoins, nous pouvons constater la présence de :language, c’est une partie variable de notre url. Grâce à cela nous allons pouvoir aller ce genre d’adresse de façon très simple :

• http://watchmydesk.local/fr/workstations
• http://watchmydesk.local/en/workstations

Les routes et l’internationalisation.

Nous allons donc maintenant traduire toutes les chaines de caractère de notre application grâce à la méthode $this->translate(). Dans notre fichier de layout :

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<?php echo $this->headTitle() ?>
<?php echo $this->headScript() ?>
<link rel="stylesheet" href="/css/main.css" type="text/css" media="screen, projection" />
<?php echo $this->headStyle() ?>
<link rel="shortcut icon" href="favicon.ico" />
</head>
<body>
	<div id="conteneur">
		<div id="top">
			<a href="<?php echo $this->url(array('language' => $this->language), 'localized_homepage') ?>" class="logo_wmd">
				<img src="/img/design/logo.png" alt="<?php echo $this->translate("Watch My Desk - Show Off your Geekstation"); ?>" title="<?php echo $this->translate("Watch My Desk - Show Off your Geekstation");?>" />
			</a>
			<p class="boutons_top">
				<a href="<?php echo $this->url(array('language' => $this->language), 'browse') ?>" class="bouton"><?php echo $this->translate("Browse"); ?></a>
				<a href="<?php echo $this->url(array('language' => $this->language), 'register') ?>" class="bouton"><?php echo $this->translate("Join Now"); ?></a>
				<a href="<?php echo $this->url(array('language' => $this->language), 'login') ?>" class="bouton"><?php echo $this->translate("Login"); ?></a>
				<a href="<?php echo $this->url(array('language' => $this->language), 'share') ?>" class="bouton"><?php echo $this->translate("Your Desk"); ?> </a>
			</p>
		</div>
		<div id="header">
			<div class="title_head">
				<h1><?php echo $this->translate("Show off"); ?><span><?php echo $this->translate("your geekstation."); ?></span></h1>
				<p><?php echo $this->translate("Watch My Desk is a website where you can share, browse and rate pictures of desks and computers of the world."); ?></p>
			</div>
			<div class="join_now">
				<p><?php echo $this->translate("Join the website to share your desk or post comments, just in 2 clics !"); ?></p>
				<a href="< ?php echo $this->url(array('language' => $this->language), 'register') ?>">
					<img src="/img/design/join_now_<?php echo $this->language ?>.png" alt="<?php echo $this->translate("Join now and show off your desk with the community !"); ?>" title="<?php echo $this->translate("Join now and show off your desk with the community !"); ?>" /></a>
			</div>
		</div>
		<div id="centre"><?php echo $this->layout()->content ?></div>
		<div id="footer"></div>
	</div>
</body>
</html>

Et enfin, nous allons éditer notre fichier de langues fr_FR.php pour y ajouter la traduction :

return array(
'hello' => 'Bonjour et bienvenue sur notre site',
'english' => 'Anglais',
'french' => 'Français',
'Watch My Desk - Show Off your Geekstation' => 'Watch My Desk - Show Off your Geekstation',
'Browse' => 'Explorer',
'Join Now' => "S'inscrire",
'Login' => 'Identification',
'Your Desk' => 'Ton Bureau',
'Show off' => 'Montre',
'your geekstation.' => 'ton bureau de geek',
'Watch My Desk is a website where you can share, browse and rate pictures of desks and computers of the world.' => 'Watch my desk est un site où vous pouvez partager, explorer et noter des photos du bureaux et ordinateurs du monde entier',
'Join the website to share your desk or post comments, just in 2 clics !' => 'Inscrivez vous pour partager vos bureaux, poster des coms... en 2 clics !',
'Join now and show off your desk with the community !' => 'Inscris-toi maintenant et partage ton bureau de geek avec la communauté !'
);

Nous avons donc traduit le design de notre application ! Simple non ?

Conclusion

Et voila ! Le design est intégré (du moins la page d’accueil) et il est traduit! Vous en pensez quoi ?

Notes

• Je suis vraiment désolé pour le retard de cet article, mais en ce moment c’est un peu chaud : Boulot, Projet et vie normale
• J’ai mis en place un site de démonstration ou vous aller pouvoir suivre l’application au fur et à mesure ! Démonstration Zend Framework pour WatchMyDesk