Difference between revisions of "Module Sites web"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
m
Tag: 2017 source edit
m
Tag: 2017 source edit
Line 64: Line 64:
  
 
== Accéder aux propriétés de la page web ==
 
== Accéder aux propriétés de la page web ==
C'est un autre exemple de contenu dynamique permettant d'obtenir des métadonnées d'un conteneur/page :
+
Voici un autre exemple de contenu dynamique permettant d'obtenir des métadonnées d'un conteneur/page :
  
 
<source lang="html">
 
<source lang="html">
__(Title)__ : <?php echo $websitepage->title; ?><br>
+
__(Titre)__ : <?php echo $websitepage->title; ?><br>
 
__(Description)__ : <?php echo $websitepage->description; ?><br>
 
__(Description)__ : <?php echo $websitepage->description; ?><br>
__(Keywords)__ : <?php echo $websitepage->keywords; ?><br>
+
__(Mots-clés)__ : <?php echo $websitepage->keywords; ?><br>
__(DateCreation)__ : <?php echo dol_print_date($websitepage->date_creation, 'dayhour', $weblangs); ?><br>
+
__(DateDeCréation)__ : <?php echo dol_print_date($websitepage->date_creation, 'dayhour', $weblangs); ?><br>
 
</source>
 
</source>
  
== Latest Blog post ==
+
== Dernier article du blog ==
This is an example of a section to show the list of latest 5 active articles (container with type "blogpost"), in english, that contains the keyword "mykeyword".
+
Voici un exemple de page qui affiche la liste des 5 derniers articles actifs (conteneur de type "blogpost"), en français, qui contient le mot-clé "monmotclé".
  
 
<source lang="html">
 
<source lang="html">
 
  <!-- Blog list -->
 
  <!-- Blog list -->
 
<section id="sectionnews" contenteditable="true" class="main section-50 section-md-50 section-md-bottom-50">
 
<section id="sectionnews" contenteditable="true" class="main section-50 section-md-50 section-md-bottom-50">
     <h2>Latest Blog posts</h2>
+
     <h2>Derniers articles du blog</h2>
 
             <div class="center">
 
             <div class="center">
 
             <?php  
 
             <?php  
             $keyword = 'mykeyword';
+
             $keyword = 'monmotclé';
 
             $weblangs->loadLangs(array("main"));
 
             $weblangs->loadLangs(array("main"));
             $arrayofblogs = $websitepage->fetchAll($website->id, 'DESC', 'date_creation', 5, 0, array('type_container'=>'blogpost', 'keywords'=>$keyword, 'status'=>'1', 'lang'=>'en'));
+
             $arrayofblogs = $websitepage->fetchAll($website->id, 'DESC', 'date_creation', 5, 0, array('type_container'=>'blogpost', 'keywords'=>$keyword, 'status'=>'1', 'lang'=>'fr'));
 
             if (is_numeric($arrayofblogs) && $arrayofblogs < 0)
 
             if (is_numeric($arrayofblogs) && $arrayofblogs < 0)
 
             {
 
             {
Line 127: Line 127:
 
</source>
 
</source>
  
== Read another remote Dolibarr database ==
+
== Lire une autre base de données Dolibarr distante ==
Just create a remote database connection and then, use this one for your SQL requests
+
Il suffit de créer une connexion à la base de données à distance et d'utiliser celle-ci pour vos requêtes SQL
  
 
<source lang="html">
 
<source lang="html">
Line 137: Line 137:
 
</source>
 
</source>
  
Note: You can also decide to use the APIs.
+
Remarque : vous pouvez également opter pour l'utilisation des API.
  
= Create a custom 404 page =
+
= Créer une page 404 personnalisée =
To create a custom 404 page, just create a common empty page with the name "404" and the type "page". Then edit the HTML content of the page with the content of your choice, and add at the end the page
+
Pour créer une page 404 personnalisée, il suffit de créer une page vide standard avec le nom "404" et le type "page". Ensuite, modifiez le contenu HTML de la page avec le contenu de votre choix, et ajoutez à la fin de la page
  
 
<source lang="html">
 
<source lang="html">
Line 146: Line 146:
 
</source>
 
</source>
  
Then you must edit your web server setup to tell to use this page as the 404 page. For example with Apache, add into your virtual host configuration:
+
Ensuite, vous devez modifier la configuration de votre serveur web pour indiquer d'utiliser cette page comme la page 404. Par exemple, avec Apache, ajoutez dans la configuration de votre hôte virtuel :
 
<source lang="ini">
 
<source lang="ini">
 
ErrorDocument 404 /404.php
 
ErrorDocument 404 /404.php

Revision as of 14:21, 2 November 2020

Sites web
Numéro/ID du module 10000
Doc utilisateur du module Cette page
Doc développeur du module Module Website (developer)

En verysmall.png Page waiting for translation. To translate, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar".
It verysmall.png Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica".
Pt verysmall.png Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar".
De verysmall.png Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten".
Zh verysmall.png 页面等待翻译。若要翻译本页,先创建一个帐户、登录并返回本页后单击“编辑”。

Introduction

Le module site web ajoute un CMS (système de gestion de contenus) à l'intérieur de Dolibar ERP CRM. Vous pouvez créer votre propre site web dans Dolibarr, publier votre site web en utilisant un serveur web externe comme Apache et NGinx et réutiliser toutes les données de votre ERP CRM dans notre site web.

Installation

Ce module est livré en standard avec la distribution de Dolibarr, aussi il est déjà installé.

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".

Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".

Le module est alors activé.

Si un pictogramme Cog circle.svg apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Créer un nouveau site web

Allez dans le menu principal "Site web" puis utilisez le bouton "Nouveau site web" pour initialiser un nouveau site web. Vous êtes prêt à ajouter votre première page.

Ajouter une nouvelle page / un nouveau conteneur

Pour ajouter votre première page, vous pouvez commencer une page à partir de zéro ou importer un site web/modèle existant que vous pourrez modifier ultérieurement.

Importer un modèle de site web

C'est le moyen le plus rapide de disposer d'un site web prêt à être publié. Cliquez sur "Importer un site web". Choisissez votre modèle ou téléchargez un modèle sur une boutique de modèles ou fourni par votre agence web.

Créer une nouvelle page à partir de zéro

Il suffit de cliquer sur le bouton "Ajouter une page / un conteneur". Remplissez les méta-informations et "Sauvegardez". Vous pouvez maintenant cliquer sur " Editer la source " pour ajouter votre contenu HTML. ...

Ajouter le contenu d'une page/conteneur dans une autre page/conteneur

L'inclusion d'un conteneur dans un conteneur parent permet de déplacer une partie du contenu (texte ou html) d'une page dans une sous-page. Vous pouvez donc l'inclure sur plusieurs pages. La modification du contenu de la sous-page sera propagée sur toute page qui inclut la sous-page. C'est similaire à l'utilisation des "Templates" avec Mediawiki ou à l'utilisation du #include en C++.

Pour inclure le contenu d'une sous-page/sous-contenu dans une autre, il suffit d'ajouter ceci à l'endroit où vous souhaitez que le sous-contenu soit inclus :

<?php includeContainer('alias_du_conteneur_a_inclure'); ?>

Ajouter de contenu dynamique dans une page

L'une des caractéristiques les plus intéressantes de Dolibarr CMS est que vous pouvez inclure du contenu dynamique en ajoutant du code PHP, n'importe où sur votre site web. Seules les personnes autorisées le font car elles ont besoin de la permission "Ajouter du contenu dynamique" pour pouvoir le faire. L'ajout de contenu dynamique est aussi simple que le développement en PHP. Il suffit d'ajouter les balises <?php / ?>. Vous pouvez utiliser, dans votre code dynamique, n'importe laquelle des variables globales prédéfinies suivantes (elles sont déjà initialisées et renseignées) :

$conf, $user, $db, $mysoc, $website, $websitepage, $weblangs, $pagelangs

Obtenez les propriétés de votre entreprise

Voici un exemple de contenu dynamique pour obtenir le nom de votre entreprise :

<?php echo $mysoc->name; ?>

Accéder aux propriétés de la page web

Voici un autre exemple de contenu dynamique permettant d'obtenir des métadonnées d'un conteneur/page :

__(Titre)__ : <?php echo $websitepage->title; ?><br>
__(Description)__ : <?php echo $websitepage->description; ?><br>
__(Mots-clés)__ : <?php echo $websitepage->keywords; ?><br>
__(DateDeCréation)__ : <?php echo dol_print_date($websitepage->date_creation, 'dayhour', $weblangs); ?><br>

Dernier article du blog

Voici un exemple de page qui affiche la liste des 5 derniers articles actifs (conteneur de type "blogpost"), en français, qui contient le mot-clé "monmotclé".

 <!-- Blog list -->
<section id="sectionnews" contenteditable="true" class="main section-50 section-md-50 section-md-bottom-50">
    <h2>Derniers articles du blog</h2>
            <div class="center">
            <?php 
            $keyword = 'monmotclé';
            $weblangs->loadLangs(array("main"));
            $arrayofblogs = $websitepage->fetchAll($website->id, 'DESC', 'date_creation', 5, 0, array('type_container'=>'blogpost', 'keywords'=>$keyword, 'status'=>'1', 'lang'=>'fr'));
            if (is_numeric($arrayofblogs) && $arrayofblogs < 0)
            {
                print '<div class="error">'.$weblangs->trans($websitepage->error).'</div>';
            }
            elseif (is_array($arrayofblogs) && ! empty($arrayofblogs))
            {
                $fuser = new User($db);
                foreach($arrayofblogs as $blog)
                {
                    print '<div class="row justify-content-sm-center row-40">';
                    print '<div class="container blog-box centpercent" style="padding: 20px; transition: .3s all ease;">';
                                print '<a href="'.$blog->pageurl.'.php">';
                                print '<div class="post-boxed-img-wrap"><img src="'.($blog->image ? 'viewimage.php?modulepart=medias&file='.$blog->image : 'medias/image/'.$website->ref.'/calendar.svg"').'" alt="" width="120"></div>';
                                print '<div class="post-boxed-caption">';
                                print '<div class="post-boxed-title font-weight-bold">'.$blog->title.'</div>';
                                print '<ul class="list-inline list-inline-dashed text-uppercase">';
                                print '<li>'.dol_print_date($blog->date_creation, 'daytext', 'tzserver', $weblangs).'</li>';
                                $fuser->fetch($blog->fk_user_creat);
                                print '<li><span>by<span> <span class="text-primary">'.($fuser->firstname?$fuser->firstname:$fuser->login).'</span></span></li>';
                                print '</ul>';
                                print '</div>';
                                //includeContainer($blog->pageurl);
                                print '<span class="nohover">'.$blog->description.'</span>';
                                print '</a>';
                    print '</div>';
                    print '</div>';
                }
            }
            else
            {
                    print '<div class="row justify-content-sm-center row-40">';
                    print '<div class="container blog-box centpercent" style="padding: 20px; transition: .3s all ease;">';
                    print $weblangs->trans("NoArticlesFoundForTheKeyword", $keyword);
                    print '</div>';
                    print '</div>';
                
            }
            ?>
            </div>
</section>

Lire une autre base de données Dolibarr distante

Il suffit de créer une connexion à la base de données à distance et d'utiliser celle-ci pour vos requêtes SQL

global $dbmaster;
$dbmaster = getDoliDBInstance('mysqli', 'myserver', 'userread', 'abcdef', 'databasename', 3306);
$confmaster = new Conf();
if ($dbmaster) $confmaster->setValues($dbmaster);

Remarque : vous pouvez également opter pour l'utilisation des API.

Créer une page 404 personnalisée

Pour créer une page 404 personnalisée, il suffit de créer une page vide standard avec le nom "404" et le type "page". Ensuite, modifiez le contenu HTML de la page avec le contenu de votre choix, et ajoutez à la fin de la page

<?php http_response_code(404); ?>

Ensuite, vous devez modifier la configuration de votre serveur web pour indiquer d'utiliser cette page comme la page 404. Par exemple, avec Apache, ajoutez dans la configuration de votre hôte virtuel :

ErrorDocument 404 /404.php

Deploy | Publish your website

To make your website live, you can click on the link "Deploy/Text my website". A popup will show you instructions to setup the web server, like Apache, so you can make your website live on the Internet. When a website is lived, it is not necessary to have Dolibarr application live, but the database must still remain started.

Note: It is not possible to have your website and Dolibarr backoffice (that is itself a website tool) using the exactly same domain name. Indeed, it is thanks to the domain name that the web server (like Apache, Nginx, ...) knows where to redirect the request (The Dolibarr Backoffice itself or the websote built by the CMS of Dolibarr). But you can choose the beginning of the name to differentiate them. For example, you can use:


Scripts