redirections manager module - smart plugs · si vous avez effectuéune migration ou que vous avez...

REDIRECTIONS MANAGER moduleGuide d’utilisation

SMART PLUGS Modules & plugins

SMART PLUGS Modules & plugins novembre 2016

Merci d’avoir fait l’acquisition du module Redirections Manager.Ce module est issu d’un travail minutieux eta, en particulier, été testé sur de nombreuses installations de Prestashop. Malgré cela, il est toujours possible que vous rencontriez un dysfonctionnement. Si tel est la cas, nous vous remercions de nous en faire part sans attendre et vous prions de nous excuser pour les désagréments occasionnés.

SOMMAIRE1 INSTALLATION & CONfIGURATION 1.1 Installation 1.2 Configuration 1.2.1 Suppression/désactivationdeproduits 1.2.2 Suppressiondecatégories,deCMS,demarquesetdefournisseurs 1.2.3 Redirectionseterreurs404 1.2.4 Redirectionsquelquesoitl’ordredesparamètresdelaquerystring

2 ACCèS APRèS INSTALLATION

3 GéRER LES REDIRECTIONS 3.1 Listedesredirections 3.2 Ajouter/Modifier

4 IMPORTER DES REDIRECTIONS 4.1 Effectuerunnouvelimport 4.1.1 étape1 4.1.2 étape2

5 ORIGINES DES REDIRECTIONS

6 OUTILS 6.1 Outildesuppressiondesredirectionsissuesdeserreurs404 6.2 Outild’exportCSV


1. INSTALLATION & CONfIGURATION1.1 InstallationL’installationdumodulesefaitcommehabituellementetsimplementvialapage«modules»duback-officedePrestashopquivouspermetd’uploaderl’archive.zipdumodulesurvotreserveur(étape1)puisdel’installer(étape2).

éTAPE 1Cliquez sur le bouton «ajouter un [nouveau]module» du back-office qui va ouvrir un encartvouspermettantdechoisirl’archive.zipdumoduleàtélécharger(uploader)survotreserveur.Unefoisquevousavezchoisicettearchive(smplredirectionsmanager.zip)cliquezsurlebouton«Chargerlemodule»(ou«mettrecemoduleenligne»surcertainesversionsdelabranche1.5de Prestashop).

éTAPE 2Aprèsavoircliquésurlebouton«Chargerlemodule»del’étapeprécédentevousdevriezêtreenmesuredeprocéderàl’installationdumoduleencliquantsimplementsurlebouton«installer»correspondantaumoduleRedirectionsManager.

Sià l’issude l’étape1Prestashopnevousproposepasuniquement lemoduleRedirectionsManagermaistouteunelistedemodulevouspouvezfiltrercettelisteparauteurenchoisissantl’auteur«smartplugs»afind’arriverrapidementaurésultatprésentésurlacaptureci-dessus.

Une fois le module installé vous pourrez accéder à sa page de configuration et à la liste des redirections via l’élément «redirections manager» ajouté dans la rubrique «adminis-tration» du menu du back-office ou de manière plus classique via le bouton «configurer» présent dans la liste des modules.


1. InstallatIon & confIguratIon

1.2 ConfigurationSil’installations’estcorrectementdérouléevousdevriezêtreredirigéverslapagedeconfiguration dumodule,cettepagevouspermettantdepositionnerlesoptionsdécritesci-après.

1.2.1 Redirections lors de la suppression et de la désactivation de produits

Lepremierencartdelapagedeconfigurationvouspermetdeconfigurerlesredirectionsautoma-tiquesencasdesuppressionetdedésactivationdeproduits.


Enregistrement automatique d’une redirection lors de la suppression d’un produit

Sivouslaissez“oui”(configurationpardéfaut)uneredirectionseraautomatiquementajoutéelorsdelasuppressiond’unproduit.• Cette redirection sera faite vers la catégoriepardéfaut associéeauproduit ou vers lapage d’accueildusite(enfonctionduchoixfaitdansl’optionsuivante«versoùrediriger»).• Toutes les redirections automatiquement enregistrées lors de la suppression d’un produit aurontpouroriginecelle indiquéedans ladeuxièmeoption suivantenommée “Originede la redirectionquandunproduitestsupprimé”.

Configuration des redirections automatiques lors de la désactivation d’un produit

Sivouslaissez“oui”(configurationpardéfaut), lesproduitsdésactivésetpourlesquelsaucuneredirectionversunautreproduitn’aétéspécifiée (viaPrestashopouvia redirectionsmanager)serontautomatiquementredirigésversleurcatégoriepardéfaut.Lesredirectionsautomatiquementeffectuéespar lemoduledans lecasd’unproduitdésactivépeuventêtredesredirections301ou302enfonctionduchoixfaitdansl’optionsuivante«typederedirectionpourlesproduitsdésactivés».

Veuillez noter que les redirections automatiques sur les produits désactivés ne sont pas enregistrées en tant que redirection dans le module mais faites «à la volée» par le module. Ces redirections cessent bien entendu d’être effectuées si les produits concernés sont réactivés.

1.2.2 Redirections lors de la suppression de catégories, de pages CMS, de marques et de fournisseurs.

Selon lemêmemodèlede fonctionnementquepour lesproduits les4encartssuivantsvouspermettentd’activerl’ajoutautomatiquederedirectionlorsdelasuppressiondecatégories,depagesCMS,demarquesetdefournisseurs.

1. InstallatIon & confIguratIon1.2Configuration

1.2.1 Redirectionslorsdelasuppressionetdeladésactivation deproduits


1. InstallatIon & confIguratIon1.2Configuration1.2.3 Enregistrement automatique de redirections lors d’erreurs 404

L’unedesgrandesforcesdumoduleRedirectionsmanagerrésidedanssacapacitéàenregistrer desredirections lorsquedeserreurs404seproduisent.Mêmesi ilest toutà faitsouhaitable etnormalqu’unsiterenvoiedeserreurs404(encasd’erreurdefrappeparexemple)poursignaler des pages introuvables, cette fonctionnalités pourrait particulièrement vous intéresser parexemplesi:●Vousavezeffectuéunemigrationetn’êtespascertaind’avoirredirigétoutesvosurls●Vousavezsupprimédespagespotentiellementimportantesdanslepassésanslesavoir redirigées

Rediriger une url correspondante à une page supprimée est particulièrement indiqué quand cette page faisait l’objet de liens externes, cas dans lequel vous perdiez (sans redi-rection) le bénéfice de ces liens (le fameux «jus SEO») en terme de référencement mais aussi l’internaute.

Réglages de baseSivoussouhaitezactiverl’enregistrementdesredirectionsencasd’erreur404,positionnezl’optioncorrespondante(«Ajouteruneredirectionquanduneerreur404survient»)ainsiquedanslacapturesuivante:

SivousavezeffectuéunemigrationouquevousavezmodifiéleschémadesurlsdansPrestashopvousdevriezcocherlacase«Tous»dansl’option«Quelstypesd’erreur404souhaitez-voustrans-formeren redirection».Celaaurapoureffetd’enregistrerune redirectionpour touteerreur404renvoyéeparvotresite(sicetteredirectionn’estpasdéjàenregistrée,casdanslequellechamp«nombrederequêtes»delaredirectionserasimplementincrémenté).


1. InstallatIon & confIguratIon1.2Configuration1.2.3 Enregistrementautomatiquederedirectionslorsd’erreurs404Dans tous lesautrescasetsi vousavezsimplementsupprimédespages (produits,catégories,CMS,marquesoufournisseurs)danslepasséetquevoussouhaitezlestransformerenredirectionsnousvousconseillonsdecocheruniquementlescasescorrespondantes.Ceréglageprovoqueral’enregistrementderedirectionsuniquementpourlesurlsconformesauxschémasd’urldéfinisdansPrestashopetéviteraqu’untropgrandnombrederedirectionssoientenregistréesparlemodule.

Veuillez remarquer que :Les redirections (sauf dans le cas de produits pour lesquels la catégorie parente peut être retrouvée) enregistrées lors d’erreur 404 ne sont bien entendu pas activées par défaut. Si vous configurez le module pour qu’il enregistre une redirection pour toute erreur 404, un grand nombre de redirections (désactivées) vont être enregistrées, certaines correspon-dant à des url ayant réellement existé sur votre site et beaucoup d’autres correspondant à des urls n’ayant jamais existé (404 correspondant à des erreurs de frappes, tentatives de hacking etc). Afin de vous aider à déterminer quelles redirections sont à conserver et éventuellement activer vous pourrez par exemple filtrer la liste des redirections pour ne conserver que les celles ayant pour origine une erreur 404 puis trier cette liste sur le nombre de requêtes, l’idée étant de ne conserver que les redirections correspondant à des urls que vous reconnaîtriez et qui auraient de plus étaient demandées plusieurs fois ce qui sera obligatoirement le cas pour une ancienne page bénéficiant de liens externes par exemple. Enfin, un outil permettant de supprimer toutes les redirection désactivées et issues d’erreurs 404 est disponible au besoin dans le module.

Réglages complémentaires

Sil’option«Ajouteruneredirectionactive...retrouvée»correspondantàlacaptureci-dessusestcochée, les redirectionsajoutées seront activéespardéfautquand le schémade l’url causant l’erreur 404 correspondauschémadéfinipourlesproduits(/categorie-defaut/ID-nom-produit.htmlpardéfaut)ETquelenomdelacatégorieprésentdansl’urlpermetderetrouverunecatégorieactuellementactive.

Sil’option«Nepastenircomptedesurls…fichiers»correspondantàlacaptureci-dessusestcochéeetquelemoduleestconfigurépourenregistreruneredirectionpourtouteerreur404,lemodulen’enregistreratoutefoispasderedirectionsil’erreur404correspondàunfichierabsenttelqu’uneimage,feuilledestyleetc.


1. InstallatIon & confIguratIon1.2Configuration

1.2.4 Redirections quel que soit l’ordre des paramètres de la querystring

Cette option, quand elle est activée, rendra par exemple possible que la requête sur “/ma-page?param2=val2&param1=val1”soitpriseenchargeparuneredirectionayantlechamp“urlàrediriger”égalà“/ma-page?param1=val1&param2=val2”.Quandunerequêteestfaitesurleserveuretquecetterequêtecontientunequerystringlemodulevadoncchercheràsavoirsiuneredirectionexistepourtouteslescombinaisonspossiblesdesparamètresdelaquerystring.

N’utilisez cette fonctionnalité que si vous en avez vraiment besoin et que vous avez bien compris les implications en terme de performance. A titre d’exemple une querystring contenant 8 paramètres donne 40320 urls différentes et qui seront toutes recherchées en base de donnée. Même si ces recherches seront réparties en N requêtes contenant P urls(avec N*P=40320), ayez conscience que ces recherches seront faites pour toute requête contenant une querystring (et si bien entendu le nombre de paramètre est inférieur à la limite qui doit être fixée dans le champ “nombre maximum de paramètres...”).


2. ACCèS APRèS INSTALLATIONAinsi que précisé au point 1.1 traitant de l’installation du module, le module est accessibledans le back-office de Prestashop :- Dans toutes les pages du back-office via le lien «Redirections Manager» qui pointe vers la liste des redirections.- De manière plus classique via le lien «configurer» du module présent dans la liste des modules et qui pointe vers la page de configuration du module.

Touteslespagesdumodule(listedesredirections,configuration,import,outils)affichentlemenuquipermetd’accéderàtouteslesfonctionnalitésdeRedirectionsManager.Cemenu,surlesversions1.6dePrestashop,devraitressembleràceci:

3. GéRER LES REDIRECTIONS3.1 Liste des redirectionsLeboutonVoir les redirectionsamèneverslalistedesredirectionsquidevraitressembler(surlesversions1.6dePrestashop)àceci:

Notons que :• Lesredirectionspeuventbienentenduêtretriéesetfiltrées.Onpeut,parexemple,ici,n’afficher quelesredirectionsissuesdeserreurs404enfiltrantsurl’originecorrespondante.• UnlienTester la redirectionainsiquesonnoml’indiquepermetdetesterchaqueredirection sansavoiràcopier/collersonURLdansunnavigateur.


Vousaurezenparticulieràsaisirl’URL quevoussouhaitezredirigeretl’URLcibleverslaquellevoussouhaitezeffectuer la redirection (lesdeuxseulschampsobligatoires).CesdeuxURLs peuventêtrerelatives(àlaracinedevotresite)ouabsolues(http://www.mondomaine/xxx/yyy).

Notez bien que le module considérera toute URL ne commençant pas par http:// ou https:// comme relative. N’écrivez donc pas d’URL comme www.mondomaine/xxx/yyy dans ces champs (il faut écrire soit xxx/yyy ou encore /xxx/yyy soit http://www.mondomaine/xxx/yyy ou https://www.mondomaine/xxx/yyy bien entendu).

Nom :Donnerunnomauxredirectionsvouspermettradelesreconnaîtreplusfacilementdanslaliste,cequifaciliteravotretravailsivousavezunjourunegrandnombrederedirections.Type :Vouspouvezchoisird’effectueruneredirection301 (quidevrait indiqueruneredirectionpermanente)ou302 (quidevraitindiqueruneredirectiontemporaire).Danslagrandemajoritédescasvouseffectuerezprobablementdesredirections301(pageouproduitsupprimé,URLappartenantàancienneversiondusiteetc.).Active :Sivousdésactivezune redirection, elle ne fonctionnerabienentenduplusmais le nombrede requêtes faites sur l’URL correspondanteauchamps“URLàrediriger”seratoujoursincrémenté.Quels que soient les paramètres de l’URL : siceparamètreestactivé,laredirectionserafaitequelsquesoientlesparamètresindiquésaprès lesigne“?”de l’URLà rediriger (cettechaîneétantcourammentappelée“querystring”).Veuilleznoterquevousdevriez,sivousactivezcechamppouruneredirectiondonnée,indiqueruneURLsansparamètres(sansquerystringdonc)dans cechamp.Danslecascontraire,lemodulesupprimeraautomatiquementlaQuerystringdel’URLindiquéedanslechamp“URLà rediriger”.Enfin, lemodule refusera l’enregistrementd’une redirectiondepage index.php avecceparamètreactivécar vous risqueriezdecréerlaredirectiondetouteslespagessileparamètre“URLssimplifiées”dePrestashop(correspondantàlaréécritured’URLs)étaitdésactivé.Nombre de requêtes effectuée :cenombreseraincrémentéautomatiquementparlemoduledèsqu’unerequêtesuruneURL correspondantauchamp“URLàrediriger”delaredirectionserafaitesurleserveur.

Autres champs

3. gérer les redirections 3.2 Ajouter / ModifierDepuislalistedesredirectionsoudepuisleboutonAjouter une redirection,vousavezaccèsauformulaired’ajoutetdemodificationdesredirectionsqui(surlesversions1.6.1.0dePrestashop)seprésenteainsi:


4. IMPORTER DES REDIRECTIONSLebouton Importerdumenudumodulepermetd’accéderàl’outild’importderedirections.Voustrouverezdanslapaged’accueildesimports,leformulairepermettantdedébuterunnouvelimportainsiquelalistedesimportsdéjàeffectués.

Comme lemessagevous l’indique,n’hésitezpasà testervosfichiersd’importcarvousseriez de toutemanière enmesure de supprimer toutes les redirection créées lors d’un import non satisfaisant,enlesupprimantdepuislalisteprésentedanscettepage.

4.1.1 étape 1

4.1 Effectuer un nouvel import

Les import s’effectuent en 2 étapes. Vous devrez, dans la première, préciser le fichier CSV contenantlesredirectionsàimporter,leséparateurdechampsutilisédanslefichier(‘,’ou‘;’engénéral)ainsiqueleséparateurdetexte(apostrophesouguillemetsengénéral).Vouspouvezaussidonnerunnomàvotreimport,unnométantautomatiquementattribuésinon.

Spécifications sur les fichiers d’importUn exemple de fichier d’import est disponible via le lien présent dans la page du module dédiée aux imports. Lemodules’attendàrecevoirdesfichiersencodésauformatUTF-8etcontenantauminimumdeux colonnes correspondantes à l’URL à rediriger et à l’URL de destination. Comme il est possibleàl’étape2despécifieruncertainnombredelignesàignorerendébutdefichier,vouspouveztoutàfaitlaisserlenomdescolonnesdansvotrefichiers’ilsapparaissentparexemplesurlapremièreligne.Lescolonnescorrespondantesauxchampssuivantspeuventenparticulierêtreimportéesetplacéesdansn’importequelordredansvotrefichier(voirétape2):


4.1.1 étape 1

URL à rediriger :champobligatoire,l’URLquevoussouhaitezredirigeretquipeutêtreuneURL relativeouabsolue.

URL de destination :champobligatoire,l’URLverslaquellevoussouhaitezredirigeretquipeutêtreuneURLrelativeouabsolue.

Type de redirection : champnonobligatoire,cechamp(s’ilestprésent)doitcontenir lavaleur“301”ou“302”.Sivouslaissezcechampsvide,lavaleurduchamp“Typederedirection”présentdansl’étape2serautiliséepourtouteslesredirectionsquevousimporterez.

Nom de la redirection :champnonobligatoirequipermetdedistinguerfacilementlaredirectiondanslalistecarplusparlantqu’uneURL.

Quelle que soit la querystring : champ non obligatoire qui permet de spécifier que la redi-rectiondoit être faitequelsquesoient lesparamètresde laquerystring (c’est àdire la chaîne?param1=val1&...&paramN=ValNsituéeenfind’URL).Cechamp,s’ilestprésent,doitcontenirlavaleur1ou0.S’ilestvide,lavaleur0serautiliséepourtouteslesredirectionsquevousimporterez.

4. Importer des redIrectIons4.1Effectuerunnouvelimport

4.1.2 étape 2


5. ORIGINES DES REDIRECTIONSDanslamesureoucertainesredirectionspeuventêtreenregistréesdemanièreautomatiqueenfonction de lamanière dont vous aurez configuré lemodule, vous aurez peut-être besoin deconnaîtreunjourlaraisond’êtredetelleoutelleredirection.C’estpourrépondreàcebesoin,enparticulier,quelechampOrigine de la redirectionaétémisenplace.

Lorsdel’installationdumodule,lesoriginessuivantessontautomatiquementcréées:•Ajoutéemanuellement•Importée•Erreur404•Suppressiondeproduit•Suppressiondecatégorie

VouspouvezcréeroumodifierlesoriginesdesredirectionsvialeboutonOrigines des redirection présentdanslemenudumodule.Veuilleznotersimplementquevousnepouvezpassupprimerlesorigines“Ajoutéemanuellement”et“Importée”.

Enfin, lesoriginesassociéesaux redirectionscréées lorsde la suppressiondeproduits, de la suppressiondecatégorieetd’erreurs404(lorsquecesoptionssontactivées)sontconfigurablesdanslapagedeconfigurationdumodule.

Lorsdeladeuxièmeétapedelaprocédured’import,vousdevriezvoirapparaîtreles5premièreslignesettoutes lescolonnesprésentesdansvotrefichierd’import (4dans lefichierquisert icid’exemple).Siuneseulecolonneestaffichéealorsquevotrefichierencontientplusieurs,c’estpro-bablementparcequevousn’avezpasspécifiélebonséparateurdechampsàl’étapeprécédente.Leslistesdechoix,endébutdecolonne,représententleschampsdumodulequevouspouvezfairecorrespondreàlacolonnedanslefichier.Sivousnesouhaitezpasimporterlesvaleursd’une colonne,vousdevezsimplementchoisirIgnorerdanslalistedechoixprésentedanscettecolonne.

Sivotrefichierdébuteparuneouplusieurslignesquevousnesouhaitezpasimporter(unelignecontenantlenomdescolonnesdufichierparexemple),vouspouvezlespécifierdanslechampNombre de lignes à ignorer en début de fichierprésententoutefindeformulaire.

Cliquezsurlebouton“Procéder à l’import”lorsquevousêtesprêt.Unrécapitulatifcontenantlenombrederedirectionsajoutéesetlenombred’erreursrencontréesdoits’afficher.

N’oubliezpasquesivousn’êtespassatisfaitd’unimport,vouspouvezlesupprimerdepuislalistedesimports,cequiaurapoureffet,enparticulier,desupprimertouteslesredirectionsquiluisontassociées.

4.1.2 étape 2

4. Importer des redIrectIons4.1Effectuerunnouvelimport


à vous !

Silemoduleestconfigurépourenregistreruneredirectionpourtouttyped’erreur404ilestfortprobablequevousvousretrouviezavecungrandnombrederedirectionsdésactivéesetnonutiles(correspondantàdeserreursdefrappeparexemple).L’outildesuppressionvouspermet-traenunclicdeprocéderàlasuppressiondetouteslesredirectionsdésactivéesetayantpourorigineuneerreur404.

6.2 Outil d’export CSV des redirections

Cetoutilpermetdoncd’exportertouteslesredirectionsdansunfichierCSV(réimportabledanslemodule).

6. OUTILSLebouton«outils»dumenudumodule(voircaptureaupoint2decettedocumentation)permetd’accéderàunoutildesuppressiondes redirectionsdésactivéesetayantcommeorigineuneerreur404ainsiqu’àunoutild’exportenCSVdesredirectionsenregistréesparlemodule.

6.1 Outil de suppression des redirections issues des erreurs

redirections manager module - smart plugs · si vous avez effectuéune migration ou que vous avez...

Documents