Thelia : Tutorial

Les premiers pas

Installation de Thelia

Thelia repose sur un serveur PHP4/MySQL classique. L'application est censée fonctionner normalement sur PHP5.

L'idéal est bien entendu d'utiliser une isntallation "LAMP" (Linux/Apache/MySQL/PHP), néanmoins vous pouvez utiliser tout type d'environnement, en particulier pour vos tests : EasyPHP, WAMP, XAMPP, MAMP...

Un PHPMyAdmin est également le bienvenu pour maintenir la base.

Une alternative consiste à installer Thelia directement chez un hébergeur. Cette façon de faire est tout à fait valable, d'autant plus qu'elle correspond à l'installation finale que vous aurez lorsque vous ouvrirez votre site d'eCommerce au public. Toutefois, elle a pour inconvénient de devoir systématiquement utiliser un outil style ftp pour mettre à jour vos pages. C'est pourquoi, pour vos premiers essais et aussi pour faciliter l'installation, nous vous conseillons de commencer par installer localement Thelia.

Installation à partir d'un outil de type EasyPHP, WAMP...

Commencez par vous procurer un pack "tout en un" qui installera sur votre machine Apache, PHP, MySQL qui sont les bases de Thelia. Pas de panique, ces packs sont extrêmement simples à installer, et prennent relativement peu de place sur votre ordinateur.

Il existe de nombreuses déclinaisons de ce concept :

Si ce n'est déjà fait, téléchargez Thelia sur www.thelia.fr. Vous obtiendrez un fichier compressé qui contient un répertoire du type "thelia_1.2".

Repérez l'emplacement de votre serveur Apache. Dans le cas d'un essai sur un EasyPHP/WAMP..., cet emplacement se caractérise par un répertoire nommé /www ou /htdocs que vous trouverez à des chemins style :

Copiez ensuite le répertoire Thelia dans cet emplacement. A des fins pratiques, vous pouvez renommez le répertoire ainsi copié afin qu'il représente votre projet. Quelques exemples :

Attention : jamais d'espace dans le nom des répertoires et fichiers. Celà vous handicaperait grandement dans le cas d'un hébergement final sous Unix.

Par la suite, vous allez utiliser une adresse de type "http://localhost/monsite/" pour accéder à votre Thelia.

Certaines versions d'Apache sont configurées pour utiliser un autre port réseau que le port standard de HTTP (80). Dans ce cas, il faut préciser ce numéro de port dans l'URL :

http://localhost:8888/monsite/, par exemple.

Installation directe chez l'hébergeur

Commencez à vous entraîner à utiliser un logiciel FTP pour transférer divers fichiers sur votre espace d'hébergement. Pour celà, vous aurez besoin de l'adresse, du login, et du mot de passe fournis par l'hébergeur.

Renommez le répertoire Thelia que vous venez de décompresser. Quelques exemples :

Transférez ensuite l'intégralité du répertoire dans votre espace d'hébergement.

Pour toute la suite de ce tutorial, il ne faudra pas utiliser une adresse style http://localhost/..., mais http://monhebergeur/... Reportez vous à la documentation fournie par l'hébergeur pour connaître l'adresse exacte à utiliser.

Définition de la base de données

Selon les cas, il faudra créer la base, ou en utiliser une existante.

Pour créer la base de données, vous pouvez utiliser l'outil PHPMyAdmin, largement diffusé avec des distributions de type LAMP. Cet outil est le plus souvent accessible avec une adresse de type http://localhost/phpmyadmin/.

Le champ "Create new database" est le plus souvent accessible dès la page d'accueil de PHPMyAdmin.

Dans certains cas, il vous faudra également créer un compte utilisateur MySQL. Ce compte devra disposer de toutes les autorisations classiques (lecture, écriture...) vers la base Thelia. Sous PHPMyAdmin, celà se passe via le lien "Privilèges" du menu principal. Cependant, le compte "standard" ('root' sans mot de passe, ou 'root' avec en mot de passe 'root' est tout à fait acceptable dans le cas d'une utilisation en local.

Dans le cas d'un hébergement distant, la question ne se pose pas : la plupart du temps, l'hébergeur aura pris soin de créer la base pour vous, et le compte qui va avec.

Dans tous les cas, vous obtiendrez au final les quatre informations suivantes qui vous seront indispensables pour utiliser Thelia :

Lancement de la procédure d'installation

Thelia intégre maintenant un programme d'installation, qui va automatiser la plupart des tâches.

Pour lancer ce programme, ouvrez votre navigateur, et tapez une adresse de type (on suppose que le répertoire de thelia s'appelle "thelia") :

ou

Si tout se passe bien, vous allez voir l'écran suivant :

Cliquez sur Continuer pour commencer l'installation en elle même.

Configuration de l'accès à la base de données

Le premier écran vous demande les coordonnées de la base de données. Utilisez les identifiants obtenus précédemment ; par exemple :

pour une installation locale

pour une installation distante (informations fournies par l'hébergeur).

L'écran suivant vous permet de choisir le nom de la base à utiliser, parmi les bases créées précédemment. Si vous ne disposez pas de base de données déjà créées, reportez vous au paragraphe précédent.

Droits d'accès

L'écran suivant contrôle diverses autorisations de lecture/écriture sur votre répertoire thelia. Si tout se passe bien, vous pourrez passer à l'étape suivant.

Mais tout n'est toujours aussi rose...

Si vous vous trouvez face à de tels messages, il vous faudra rendre les répertoires de Thelia accessibles en écriture, au moins dans un premier temps. N'oubliez pas le fichier Cnx.class.php.orig !

Si vous fonctionnez sur une installation locale, il faudra configurer les droits d'accès des répertoires un à un (bouton droit / Propriétés, la plupart du temps)

Si vous fonctionnez sur un hébergement distant, vous allez pouvoir modifier ces droits d'accès via la fonction "chmod" de votre client FTP. Cette fonction se trouve en cliquant avec le bouton droit sur le répertoire distant à reconfigurer, puis "Propriétés"

Dans un premier temps, l'idéal est de cocher toutes les autorisations (777 en jargon "chmod"). Si vous configurez ainsi un hébergement distant, il faudra par la suite réviser ces autorisations pour éviter de trop gros trous de sécurité.

Sur la photo d'écran précédente, certaines autorisations en écriture ne sont pas cochées. Il faudra le faire pour pouvoir installer Thelia.

Une fois toutes les autorisations fixées, cliquez sur le bouton Rafraichir, qui devrait vous permettre de valider le tout, et de passer à l'étape suivante.

Paramétrages de l'interface d'administration

L'écran suivant permet de définir les paramètres de base de Thelia. Vous pourrez modifier ces paramètres par la suite.

Comme vous pouvez le remarquez, l'intégralité de ces paramètres concernent uniquement l'interface d'admin. En effet, contrairement à d'autres solutions d'eCommerce, Thelia ne gère pas d'interface prédéfinie pour le site en lui même : vous en avez un contrôle intégral via le design et la conception de vos diverses pages.

Fin de l'installation

La procédure d'installation se termine par une connexion automatique à l'écran d'administration, pour vérifier que tout va bien. Par la suite, vous pourrez revenir sur cet écran en utilisant une URL qui va ressembler à : 

    http://localhost/monsite/admin/index.php

Vous allez utiliser le login et mot de passe d'administration tels que vous les aurez défini précédemment.

Si vous parvenez à vous connecter correctement, vous pouvez considérer que l'installation est terminée !

Même si vous êtes sans doute pressés de vous attaquer à votre premier site, prenez toute de même un peu de temps pour finaliser l'installation en faisant un peu de ménage qui sécurisera votre site. Supprimez entre autre le répertoire "install", et vérifiez les droits en écriture des répertoires, fichiers de configuration... Normalement, la procédure d'installation aura fait l'essentiel du ménage sur ces droits d'accès.

Création du premier squelette

Maintenant que Thelia est opérationnel, vous allez pouvoir commencer a écrire vos premiers squelettes. Ces squelettes sont les bases des pages qui vont constituer votre site de vente en ligne.

Une page structurée par Thelia est systématiquement composée de deux fichiers :

Vous allez stocker les fichiers dans le répertoire que vous avez créé au préalable pour votre site.

Commencez par créer un fichier texte avec l'éditeur de votre choix. Nommez ce fichier : prem.php.

Ce fichier va contenir les lignes suivantes :

<?
  $fond="prem.html";
  include("fonctions/moteur.php");
?>

Créez ensuite le fichier prem.html qui va contenir le corps de votre page.

Cette page est avant tout une page HTML classique. Vous pouvez donc l'éditer avec votre outil habituel. Il existe d'ailleurs une barre d'outils permettant de gérer les balises Thelia sous Dreamweaver.

Nous allons faire un premier essai avec le fichier suivant : 

<html>
<body>
<h1>Titre</h1>
<p>Page en cours : #URLCOURANTE</p>
<p><a href="#URLSOMMAIRE">Retour au sommaire</a></p>
</body>
</html>

Cette page, minimaliste, utilise deux balises spécifiques à Thelia :

Une fois ces deux pages sauvegardées, vous pouvez tester la page en tapant une URL du style : 

http://localhost/monsite/prem.php