Comment activer le mode URL Rewrite de Thelia : Différence entre versions
m |
|||
Ligne 1 : | Ligne 1 : | ||
+ | === Activer la ré-écriture des URLs dans Thelia === | ||
+ | |||
'''Etape 1''' | '''Etape 1''' | ||
− | Vérifier que votre hébergement est compatible avec le mod_rewrite d'Apache (URL Rewriting) | + | Vérifier que votre hébergement est compatible avec le module mod_rewrite d'Apache (URL Rewriting) |
'''Etape 2''' | '''Etape 2''' | ||
− | + | Dans le back-office -> Configuration -> Gestion des variables, donner la valeur 1 à la variable 'rewrite'. | |
− | + | ||
− | + | ||
'''Etape 3''' | '''Etape 3''' | ||
− | + | Déplacer le fichier template/htaccess à la racine du site, et le renommer .htaccess (point-htaccess) | |
+ | |||
+ | '''Conseils''' | ||
+ | Dans vos templates, ne codez pas "en dur" les URLs, mas utilisez utilisez la variable #URL des boucles rubriques, produit, dossier et contenu, ou la substitution #URLFOND. | ||
+ | |||
+ | <THELIA_rub type="produit" id="#PRODUIT_ID"> | ||
+ | <a href="#URL">#TITRE</a> | ||
+ | </THELIA_rub> | ||
+ | |||
+ | Vous pouvez utiliser un plugin de gestion des ré-ecritures (comme [http://thelia.net/contributions/plugins/divers-60/article/gestions-des-r Gestions des réecritures d’URL]) pour créer les URLs ré-écrite de vos propres templates, ou des templates de base. ?fond=panier pourra alors devenir mon-panier.html | ||
+ | |||
+ | === #URLFOND === | ||
+ | |||
+ | La substitution #URLFOND(nom_template,paramètres) permet de construire l'URL d'une page de votre boutique. Par exemple, #URLFOND(moncompte) vous permet de générer le lien vers la page mon compte. #URLFOND utilisera l'URL ré-ecrite si elle est disponible. | ||
+ | |||
+ | Par exemple, utiliser: | ||
+ | |||
+ | <a href="#URLFOND(livraison_modifier,adresse=#ID)">Modifier mon adresse de livraison</a> | ||
+ | |||
+ | plutôt que: | ||
+ | |||
+ | <a href="?fond=livraison_modifier&adresse=#ID">Modifier mon adresse de livraison</a> | ||
+ | |||
+ | === #AJOUTER_PARAMETRE === | ||
+ | |||
+ | A partir de Thelia 1.5.3, vous pouvez utiliser la substitution #AJOUTER_PARAMETRE pour ajouter des paramètres à une URL sans vous préoccuper de savoir si elle a déjà des paramètres ou non, et donc de décider s'il faut utiliser ? ou & pour ajouter vos paramètres. | ||
+ | |||
+ | Par exemple, pour ajouter panier=1 à l'URL de la page courante, utiliser: | ||
+ | |||
+ | #AJOUTER_PARAMETRE(#URLCOURANTE,panier=1) | ||
+ | |||
+ | L'URL sera ainsi toujours formée correctement. |
Version du 21 novembre 2012 à 11:08
Activer la ré-écriture des URLs dans Thelia
Etape 1 Vérifier que votre hébergement est compatible avec le module mod_rewrite d'Apache (URL Rewriting)
Etape 2 Dans le back-office -> Configuration -> Gestion des variables, donner la valeur 1 à la variable 'rewrite'.
Etape 3 Déplacer le fichier template/htaccess à la racine du site, et le renommer .htaccess (point-htaccess)
Conseils Dans vos templates, ne codez pas "en dur" les URLs, mas utilisez utilisez la variable #URL des boucles rubriques, produit, dossier et contenu, ou la substitution #URLFOND.
<THELIA_rub type="produit" id="#PRODUIT_ID"> <a href="#URL">#TITRE</a> </THELIA_rub>
Vous pouvez utiliser un plugin de gestion des ré-ecritures (comme Gestions des réecritures d’URL) pour créer les URLs ré-écrite de vos propres templates, ou des templates de base. ?fond=panier pourra alors devenir mon-panier.html
#URLFOND
La substitution #URLFOND(nom_template,paramètres) permet de construire l'URL d'une page de votre boutique. Par exemple, #URLFOND(moncompte) vous permet de générer le lien vers la page mon compte. #URLFOND utilisera l'URL ré-ecrite si elle est disponible.
Par exemple, utiliser:
<a href="#URLFOND(livraison_modifier,adresse=#ID)">Modifier mon adresse de livraison</a>
plutôt que:
<a href="?fond=livraison_modifier&adresse=#ID">Modifier mon adresse de livraison</a>
#AJOUTER_PARAMETRE
A partir de Thelia 1.5.3, vous pouvez utiliser la substitution #AJOUTER_PARAMETRE pour ajouter des paramètres à une URL sans vous préoccuper de savoir si elle a déjà des paramètres ou non, et donc de décider s'il faut utiliser ? ou & pour ajouter vos paramètres.
Par exemple, pour ajouter panier=1 à l'URL de la page courante, utiliser:
#AJOUTER_PARAMETRE(#URLCOURANTE,panier=1)
L'URL sera ainsi toujours formée correctement.