wiki:extensv15:wordpress

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision		 Révision précédente
wiki:extensv15:wordpress [2023/06/12 10:13] – [Icones de statut] jsiegwaldwiki:extensv15:wordpress [2024/03/31 22:04] (Version actuelle) – [Icones de statut] jsiegwald
Ligne 1: Ligne 1:
 +====== WORDPRESS Espace client sous Wordpress ======
 +{{:wiki:v15:extensions:wordpress_01.png?nolink|}}
 +
 +Ce module a été développé pour que vous puissiez proposer à vos clients un espace membre sur votre site, dans lequel ils pourront trouver :\\
 +  * Les coordonnées que vous avez enregistrées (utile s'il déménage et qu'il ne sait pas sous quelle adresse il est connu)
 +  * Ses devis
 +  * Ses factures (avec un lien vers un paiement Paypal)
 +  * Ses documents
 +  * Ses commandes
 +  * Ses interventions
 +
 +
 +<btn type="primary" size="sm" icon="glyphicon glyphicon-shopping-cart">[[https://www.lcpstudio.fr/commande-2|Acheter en ligne sur la boutique LCP Studio]]</btn>
 +//Extension LCP Studio proposée au prix de 290€ HT.//
 +
 +===== Principe de fonctionnement =====
 +
 +Dans Gestan, vous créez pour un contact un accès à son espace client. Il sera alors automatiquement reporté dans Wordpress. Une fois que le client se connecte à votre site, il pourra voir les informations qui le concernent : coordonnées, devis, factures, commandes, documents et interventions.
 +
 +Voilà une présentation en video de la simplicité d'utilisation.
 +
 +{{ :wiki:extensmetierv15:wordpress.mp4?nolink&720x576 |}}
 +
 +(vous pouvez mettre cette video en plein écran.)
 +
 +===== Installation et paramétrage =====
 +
 +Vous pouvez installer librement l'extension, disponible via l'écran de gestion des ressources Gestan dans une version valable 30 jours. Si elle vous convient, passez commande de la version de production, via [[https://www.gestan.fr/le-pack-gestanwordpress/|ce formulaire]]. Nous vous enverrons la version de production, qui sera valide pour toutes les machines de votre entreprise, et la facture correspondante.
 +
 +L'installation et le paramétrage sont décrits en détail dans le tutorial ci-dessous, conçu pour que vous puissiez réaliser l'opération tout seul. Cependant, nous pouvons aussi réaliser l'installation et le paramétrage, selon deux formules :
 +  * une formule comprenant l'installation sur votre site Web, et la mise en cohérence graphique du plugin wordpress si elle est nécessaire
 +  * une formule comprenant la création ou la reprise de votre site web sous wordpress, avec l'intégration du module wordpress pour Gestan.
 +
 +Voir conditions sur la page de commande sur le site de Gestan ([[https://www.gestan.fr/le-pack-gestanwordpress/|ce lien]]).
 +
 +==== Pré-requis ====
 +
 +Il vous faut :
 +  * Un site sous **Wordpress**
 +  * Un **accès FTP**
 +  * L'extension **Gestan pour Wordpress** disponible ici {{ :wiki:extensv15:gestan.zip |}}
 +
 +
 +Il faut que **votre base MySql soit accessible depuis l'extérieur**, ce qui n'est pas toujours le cas chez tous les hébergeurs. Il vous faut aussi un peu d'espace disque (1 facture~=60Ko), mais ce point est très rarement bloquant.
 +
 +===== Installation côté Wordpress =====
 +
 +
 +==== Installation de l'extension ====
 +
 +Installez normalement l'extension "Gestan pour Wordpress".
 +
 +  * connectez-vous comme administrateur au backoffice de votre site (habituellement, "www.votresite.fr/wp-admin")
 +  * allez sur la page des extensions puis cliquez sur le bouton "ajouter".
 +  * cliquez sur le bouton "Mettre une extension en ligne" puis sélectionnez le fichier "Gestan.zip" précédemment téléchargé.
 +  * enfin, activez l'extension.
 +
 +{{ :wiki:v15:extensions:wordpress_03.png?nolink&800 |}}
 +
 +Cette extension va créer 7 tables dans la base de données de votre site Wordpress: une pour les clients, une pour les factures, une pour les devis, une pour les interventions, une pour les commandes, une pour les documents et enfin une pour les paramétrages.
 +
 +Elle créée également des //shortcodes// (Un shortcode dans Wordpress est un petit code entre crochets ([ ]) qui permet une multitude de fonctionnalités. Vous pouvez placer ces shortcodes n'importe où : dans une barre latérale, une page, un article, etc... avec toute la puissance de Wordpress).
 +
 +Concrètement, vous pouvez utiliser les shortcodes Gestan pour afficher les données qui seront envoyées par Gestan. Par exemple, si vous mettez "[Gestan_Prenom]" dans une page, il remplacera ce shortcode par le prénom de l'utilisateur connecté.
 +
 +En voici la liste complète:
 +  * **[Gestan_Email]**: Email du contact
 +  * **[Gestan_Civilite]**:Civilité courte du contact
 +  * **[Gestan_Prenom]**: Prénom du contact
 +  * **[Gestan_Nom]**: Nom du contact
 +  * **[Gestan_Raison_Sociale]**: Raison sociale de la société
 +  * **[Gestan_Adresse1]**: 1ère ligne d'adresse du contact
 +  * **[Gestan_Adresse2]**: 2ème ligne d'adresse du contact
 +  * **[Gestan_CP]**: Code postal du contact
 +  * **[Gestan_Ville]**: Ville du contact
 +  * **[Gestan_Telephone_Portable]**: Téléphone portable du contact
 +  * **[Gestan_Telephone_Fixe]**: Téléphone fixe du contact
 +  * **[Gestan_Date_Naissance]**: Date de naissance du contact
 +  * **[Gestan_Coordonnees]**: L'ensemble des coordonnées du contact (les éléments non-renseignés ne seront pas affichés)
 +  * **[Gestan_Factures]**: Affiche un tableau contenant un résumé des factures, avec la possibilité de les télécharger et/ou de les payer
 +  * **[Gestan_Factures telechargeable="faux"]**: Affiche un tableau contenant un résumé des factures, sans possibilité de les télécharger
 +  * **[Gestan_Facture tri="vrai"]**: Tri les factures par raison sociale de société.
 +  * **[Gestan_Devis]**: Affiche un tableau contenant un résumé des devis, avec la possibilité de les télécharger
 +  * **[Gestan_Devis telechargeable="faux"]**: Affiche un tableau contenant un résumé des devis, sans possibilité de les télécharger
 +  * **[Gestan_Devis tri="vrai"]**: Tri les factures par raison sociale de société.
 +  * **[Gestan_Interventions]**: Affiche un tableau contenant un résumé des interventions, avec la possibilité de les télécharger
 +  * **[Gestan_Interventions telechargeable="faux"]**: Affiche un tableau contenant un résumé des interventions, sans possibilité de les télécharger
 +  * **[Gestan_Commande]**: Affiche un tableau contenant un résumé des commandes, avec la possibilité de les télécharger
 +  * **[Gestan_Commande telechargeable="faux"]**: Affiche un tableau contenant un résumé des commandes, sans possibilité de les télécharger
 +  * **[Gestan_Commande tri="vrai"]**: Tri les factures par raison sociale de société.
 +  * **[Gestan_Commande livraison="faux"]**: Affiche un tableau contenant un résumé des commandes, sans affichage de la date de livraison
 +  * **[Gestan_Document]**: Affiche un tableau contenant un résumé des documents, avec la possibilité de les télécharger
 +  * **[Gestan_Document tri="Projet"]**: Affiche un tableau contenant un résumé des documents, triés par projet.
 +
 +TIP <wrap hi>Les options sont cumulables: vous pouvez par exemple faire un shortcode [Gestan_Commande telechargeable="faux" livraison="faux"] !</wrap>
 +
 +Les pages sont automatiquement créées depuis la version 1.4 de l'extension (mais vous pourriez aussi tout mettre sur une seule page, ou ajouter d'autres pages selon les besoins), par exemple :
 +
 +**une page coordonnées**
 +<code>
 +Bonjour [Gestan_Prenom],
 +
 +Bienvenue dans votre espace client, dans lequel vous pourrez retrouver devis et factures émis par blabla, et régler en ligne si vous possédez une carte bancaire ou un compte Paypal.
 +
 +Voici vos coordonnées telles que nous les avons enregistrées. Si elles sont inexactes, demandez-nous de les corriger.
 +
 +[Gestan_Civilite] [Gestan_Prenom] [Gestan_Nom]
 +[Gestan_Coordonnees]</code>
 +une page devis
 +<code>
 +Voici la liste des devis établis à votre intention :
 +
 +[Gestan_Devis]
 +</code>
 +une page factures
 +<code>
 +Voici la liste des factures établies pour votre compte.
 +
 +[Gestan_Factures]
 +</code>
 +
 +Créez les menus pour afficher ces trois pages (Selon votre thème WordPress, vous pouvez utiliser une extension comme Widget Logic pour afficher ce menu sur certaines pages et pas d'autres).
 +
 +Pour gérer l'aspect Espace Membre, vous pouvez utiliser le suffixe wp-admin sur votre site ou une extension faite pour cela (Vous pouvez utiliser "Member Access")
 +
 +Pour la page de connexion, faites une page "Espace Membre", avec par exemple ce simple formulaire :
 +<code>
 +<form name="loginform" id="loginform" action="http://www.blabla.com/wp-login.php" method="post"> 
 +<p class="login-username">
 +<label for="user_login">Identifiant</label>
 +<input type="text" name="log" id="user_login" class="input" value="" size="20">
 +</p>
 +
 +<p class="login-password">
 +<label for="user_pass">Mot de passe</label>
 +<input type="password" name="pwd" id="user_pass" class="input" value="" size="20">
 +</p>
 +
 +<p class="login-remember">
 +<label><input name="rememberme" type="checkbox" id="rememberme" value="forever"> Se souvenir de moi</label> | <a href="http://www.blabla.com/wp-login.php?action=lostpassword">Mot de passe oublié</a>
 +</p>
 +
 +<p class="login-submit">
 +<input type="submit" name="wp-submit" id="wp-submit" class="button-primary" value="Se connecter">
 +<input type="hidden" name="redirect_to" value="http://www.blabla.com/vos-coordonnees/">
 +</p> 
 +</form>
 +
 +
 +</code>
 +WARNING <wrap em>N'oubliez pas de déclarer la visibilité de ces pages comme privées !</wrap>
 +
 +
 +===== Installation côté Gestan =====
 +
 +==== Installation de l'extension ====
 +
 +Installez l'extension Gestan. Pour cela, via **Outils > Administration > Ressources complémentaires** et cherchez le module nommé "GESTAN_WORDPRESS", puis cliquez sur "Install". Il sera alors automatiquement téléchargé et installé. Pensez à l'activer !
 +
 +Les extensions, qu'elles soient de démonstration ou de production, sont installées dans le répertoire des ressources du programme "Data Utilisateur" (vous pouvez ouvrir ce répertoire via Outils > Administration > Répertoires et fichiers, cf ci dessous).
 +{{ :wiki:addons:wordpress:data_utilisateur.jpg?nolink |}}
 +
 +
 +==== Paramétrage du module ====
 +
 +Ouvrez la fenêtre de paramétrages via **Outils > Paramètre de l'application > Paramétrage des Add-Ons > Espace client Wordpress**.
 +
 +==== Page "Paypal" ====
 +
 +Vous avez la possibilité de recevoir des paiements Paypal depuis votre site. Pour cela, vous devez indiquer:
 +  * **Adresse Paypal de réception des paiments** : un email rattaché à un compte Paypal sur lequel vous recevrez les paiements.
 +  * **Page de retour si le paiement est accepté** : l'URL complète de retour si le paiement a abouti (une page créée disant au client que le paiement a bien été reçu)
 +  * **Page de retour si le paiement est refusé** : l'URL complète de retour si le paiement est refusé ou qu'il a été annulé (une page créée disant au client que le paiement n'a pas abouti)\\
 +
 +{{ :wiki:v15:extensions:wordpress_04.png?nolink&500 |}}
 +
 +
 +
 +==== Page "Email" ====
 +
 +Dans cet onglet, créez un message-type qui pourra être envoyé au client une fois son accès créé.
 +
 +Là aussi, utilisez les mots-clés disponibles de Gestan :
 +  * **%CIVILITE%**: Civilité courte du contact
 +  * **%PRENOM%**: Prénom du contact
 +  * **%NOM%**: Nom du contact
 +  * **%EMAIL%**: Email du contact
 +  * **%TELEPHONE_PORTABLE%**: Téléphone portable du contact
 +  * **%TELEPHONE_DOMICILE%**: Téléphone domicile du contact
 +  * **%ADRESSE1%**: 1ère ligne d'adresse du contact
 +  * **%ADRESSE2%**: 2ème ligne d'adresse du contact
 +  * **%CP%**: Code postal du contact
 +  * **%VILLE%**: Ville du contact
 +  * **%CHAINE_ALEATOIRE%**: Mot de passe généré aléatoirement
 +
 +
 +{{ :wiki:v15:extensions:wordpress_05.png?nolink&500 |}}
 +
 +
 +
 +==== Page "SQL" ====
 +
 +Cet onglet vous permet d'entrer les accès à la base SQL. 
 +  * **Adresse du serveur**: Adresse URL ou IP de votre serveur de base de données
 +  * **Nom de la base de données**: Nom de la base de données Worpdress
 +  * **Utilisateur**: Nom d'utilisateur ayant accès à la base (avec droits de lecture et d'écriture)
 +  * **Mot de passe**: Mot de passe de l'utilisateur lié à la base
 +  * **Préfixe de la base**: Préfixe de la base Wordpress, "wp_" par défaut
 +
 +{{ :wiki:v15:extensions:wordpress_06.png?nolink&500 |}}
 +
 +
 +
 +<WRAP round tip >
 +Vous pouvez trouver ces informations dans le fichier wp-config.php de votre serveur, où:
 +  * L'adresse du serveur peut être "DB_HOST" (sauf dans le cas où il est "localhost")
 +  * Le nom de la base de données est défini par "backupge_wp"
 +  * L'utilisateur est défini par "DB_USER"
 +  * Le mot de passe est défini par "DB_PASSWORD"
 +  * Le préfixe de la base est défini par "$table_prefix"
 +
 +N'hésitez pas à contacter votre hébergeur pour vous aider à l'accès MySQL Distant
 +</WRAP>
 +
 +
 +==== Page "FTP" ====
 +
 +Afin d'envoyer les factures et devis sur le serveur, le module a besoin d'un accès FTP.
 +  * **Serveur FTP**: L'adresse ftp de votre serveur (souvent le nom de domaine précédé de "ftp.")
 +  * **Nom d'utilisateur**: Le nom d'utilisateur de l'accès FTP
 +  * **Mot de passe**: Le mot de passe lié à l'utilisateur pour l'accès FTP
 +  * **Numéro de port**: Le port utilisé pour l'accès FTP (par défaut, 21, qui correspond à une connexion non-sécurisée)
 +
 +La case "Afficher un popup en fin d'opération" permet d'afficher une fenêtre discrète en bas à droite de votre écran pour vous signaler la fin du traitement de transmission des factures et devis.
 +
 +<wrap center round info >
 +Les pièces seront uploadés dans des dossiers nominatifs ("Factures" par exemple), puis classés par ID de contact Gestan.
 +</wrap>
 +
 +{{ :wiki:v15:extensions:wordpress_07.png?nolink&500 |}}
 +
 +
 +===== Utilisation =====
 +
 +=== Fenêtre "Liste des accès" ===
 +
 +Vous pouvez voir via **Métier > Espace client Wordpress > Liste des accès** la liste des accès en cours.
 +
 +Vous pouvez également supprimer l'accès d'un client via cette fenêtre.
 +
 +Le bouton "Ajouter" permet d'accéder à la ...
 +
 +=== Fenêtre "Nouvel accès" ===
 +
 +Qui permet de créer un accès pour un nouveau client ou un client existant.
 +
 +En cochant la case "**envoyer un mail de création de compte**", un aperçu d'email sera visible avec les mots de passe client.
 +
 +Les factures et devis existants pour ce client seront également automatiquement télé-versés vers Wordpress (cela peut prendre un certain temps suivant votre ordinateur et votre connexion Internet).
 +
 +{{ :wiki:v15:extensions:wordpress_08.png?nolink&500 |}}
 +
 +
 +Toutes les 30 minutes, une routine exportera automatiquement vos pièces pour les accès existant. Vous n'avez donc rien à faire.
 +Elle est pas belle la vie ?
 +
 +<WRAP center round important 80%>
 +Il faut que les pièces soient notées comme "transmises" pour être transférées vers Wordpress
 +</WRAP>
 +=== Fenêtre "Outils" ===
 +{{ :wiki:extensv15:fenetre_envoi.png?nolink |}}
 +
 +
 +Via **Métier > Espace client Wordpress > Outils**, vous avez accès à un écran qui permet de vérifier quels sont les pièces/documents/interventions à synchroniser. Trois états sont disponibles à la lecture des enregistrements:
 +  * **A jour**: Tout va bien, la pièce a déjà été transmise et est à jour.
 +  * **A importer** : La pièce nécessite d'être synchronisée, et cela n'a jamais été fait auparavant.
 +  * **Mise à jour** : La pièce a déjà été envoyée vers Wordpress, mais a été modifiée dans Gestan depuis.
 +
 +Vous pouvez décider de ne lire qu'uniquement les pièces d'un contact via le bouton "Vérifier pour un contact" et en saisissant son ID (que vous pouvez trouver dans la table des contacts de Gestan).
 +
 +Une fois la lecture effectuée, cochez les cases des pièces à transférer, puis cliquez sur "Synchroniser".
 +
 +
 +==== Autres personnalisations ====
 +
 +=== Bidouilleurs ? Amusez-vous ! ===
 +ATTENTION: ces manipulations sont réservées à ceux qui en sont capables ! Nous ne serons pas tenus pour responsables si vous faites des bêtises !
 +
 +Déjà, vous pouvez décorer votre page login.php à votre souhait: c'est toujours plus chouette pour les clients (plusieurs plugins existent pour cela).
 +
 +Vous pouvez également ajouter ces différentes fonctions dans votre fichier function.php:
 +
 +__Verrouiller l'accès à une page__
 +
 +<code>
 +add_action( 'template_redirect', 'private_page' );
 +function private_page() {
 + if ( is_page(15617) && ! is_user_logged_in() ) {
 + wp_redirect( wp_login_url( get_permalink(5) ) );
 + exit();
 + }
 +}
 +</code>
 +
 +__Redirection après déconnexion__
 +<code>
 +function jul_logout_redirect()
 +{
 +wp_redirect(home_url());
 +exit;
 +}
 +
 +add_action('wp_logout', 'jul_logout_redirect');
 +</code>
 +
 +__Redirection après connexion__
 +<code>
 +add_filter("login_redirect", "roles_login_redirect", 10, 3);
 +
 +function roles_login_redirect($redirect_to, $request, $user)
 +{
 +if (is_array($user->roles))
 +if (in_array('administrator', $user->roles)) return admin_url(); // Page -> Tableau de bord
 +return home_url("/espace-membre/"); // Les abonnés sont redirigés en Page d'accueil
 +}
 +</code>
 +
 +=== Couleurs et aspect du tableau ===
 +Vous pouvez changer les couleurs du tableau, en mettant dans votre page un CSS personnalisé.
 +
 +Par exemple, pour obtenir le tableau ci-dessous, utilisez le CSS suivant :
 +<code>
 +<style type="text/css">  
 +  <!-- 
 +  table.Gestan { 
 +    margin-bottom: 21px; 
 +    width: 100%; 
 +    text-align: center; 
 +  } 
 +  th { 
 +    background: #045D9F; 
 +    color: #FFF; 
 +    line-height: 30px; 
 +    font-weight: bold; 
 +    font-size: 13px; 
 +    vertical-align: top; 
 +    margin-right:7px; 
 +    margin-left:7px; 
 +    padding-right:7px; 
 +    padding-left:7px; 
 +  } 
 +  tr { 
 +    background: #dce2e5; 
 +    line-height: 30px; 
 +    border-top: 1px solid darkgrey; 
 +    border-bottom: 1px solid darkgrey; 
 +    font-size: 13px; 
 +  } 
 +  tr:nth-child(even) { 
 +    background-color:#E5F2FA; 
 +  } 
 +  tr:nth-child(odd) { 
 +    background-color:#C1E3FA; 
 +  } 
 +  tr:hover{ 
 +    background-color: #F2F2F2; 
 +  } 
 +  td { 
 +    vertical-align: top; 
 +    font-size: 14px; line-height: 24px; 
 +    text-align: center; 
 +    padding-left:7px; } 
 +    td.Factures_Libelle, td.Devis_Libelle{ 
 +    text-align: left; 
 +    padding-left: 5px; 
 +  } 
 +    td.Factures_Montant, td.Devis_Montant{ 
 +    text-align: right; padding-right: 5px; 
 +  } 
 +  -->
 +</style>
 +</code>
 +{{:wiki:v15:extensions:wordpress_10.png?nolink|}}
 +=== Icones de statut ===
 +Vous pouvez changer les icones de statut : il s'agit des fichiers Check.png et Paiement.png situés dans /wp-content/plugins/Gestan/img
 +
 +^Version ^Date ^Observations^
 +|3.15.51.1H |31/03/24| Fixbug en changement de base|
 +|3.15.51.1G |12/06/23| Fixbug et ajout de fonction de licence|
 +|3.15.51.1D |08/07/21| Amélioration de la gestion du Widget|
 +|3.15.51.1C |28/05/20| Possibilité de créer des comptes par lot|
 +|3.15.51.1A |13/11/19| Suppression de la page des options au profit d'une page d'envoi générique, ajout d'un widget qui gère le rafraîchissement|
 +|3.15.50.1A |10/09/19| Possibilité de tri des pièces par raisons sociales, possibilité de renseigner un mot de passe à la création de l'espace membre, possibilité de changer le mot de passe|
 +|3.15.00.00 |22/11/17| Migration en Gestan 15|
 +
 +-----------------
 +{{:wiki:tags:voir_aussi.gif?nolink |}}**Autres articles "Extensions"**
 +
 +<nspages wiki:extensv15 -nbCol=2 -textPages="" -h1 -r -simpleLineBreak >
 +~~DISCUSSION~~