Guide d’installation

DocumentationDernière mise à jour: 29.10.2026

Ce guide s’applique à tous les sites Northbytra — le site Services informatiques et techniques et tous les sites sectoriels. Une installation type prend environ 30 minutes. Il vous faut un logiciel FTP (p. ex. FileZilla) et les identifiants de votre hébergement.

1. Choisir le bon package

Site : le site Services informatiques et techniques (réparation informatique, services informatiques, caméras de surveillance — avec suivi des réparations en ligne) ou un site sectoriel : Cabinet d’architecture, Entreprise de construction, Entreprise d’électricité, Studio d’architecture d’intérieur, Installateur solaire, Magasin et fabricant de meubles, Garage et entretien automobile, Centre de pneus, Dépannage et assistance routière, Carrosserie et peinture, Location de véhicules, Concession automobile, ou le Site pour votre entreprise pour tout autre secteur. Comparez-les sur la page des produits et dans les démos en ligne.
Édition : Standard — commandes par virement bancaire, paiement à la livraison ou en boutique. Pro — en plus, paiement en ligne par carte via PayTR ou Stripe. Les deux éditions s’installent de la même manière ; vous pouvez passer de Standard à Pro plus tard et votre clé d’activation reste la même.
Un package = un secteur : le design, le menu, les modules et le contenu d’exemple d’un package sont conçus pour son secteur. Tous les textes, images et modules peuvent être modifiés dans le panneau d’administration, mais le secteur d’un package ne peut pas être remplacé par un autre.
Après le paiement, vous recevez un e-mail avec le lien vers votre page de commande : vous y affichez votre clé d’activation et utilisez votre lien de téléchargement personnel ; après la fin du droit de rétractation, une copie de la clé peut également vous être envoyée par e-mail. Le fichier ZIP contient le dossier upload et la documentation (INSTALL.md / KURULUM.md).

2. Prérequis

PHP 8.1 ou plus récent avec les extensions pdo_mysql, sodium, mbstring et fileinfo (gd et intl recommandées) — standard sur la plupart des hébergements
MySQL 5.7+ ou MariaDB 10.3+
Apache ou LiteSpeed avec mod_rewrite — ou Nginx avec les règles de la section 10
Un certificat SSL pour votre domaine (gratuit avec Let's Encrypt chez la plupart des hébergeurs)

L’assistant d’installation vérifie chaque prérequis avant le début de l’installation.

3. Téléverser les fichiers par FTP

Décompressez le fichier ZIP sur votre ordinateur.
Connectez-vous à votre hébergement par FTP — de préférence SFTP ou FTPS — et téléversez le contenu du dossier upload à la racine web de votre domaine (souvent public_html, httpdocs ou htdocs), y compris les fichiers cachés .htaccess.
Dans le panneau de votre hébergement, créez une base de données MySQL vide et un utilisateur de base de données disposant de tous les privilèges sur celle-ci. Notez le nom de la base, le nom d’utilisateur et le mot de passe.

4. Lancer l’assistant d’installation

Ouvrez votre domaine dans le navigateur — l’assistant démarre automatiquement. Vous pouvez changer sa langue en haut de la page.
Saisissez les informations de la base de données et les informations de votre entreprise.
Choisissez la langue par défaut du site et du panneau d’administration, les langues que vous souhaitez proposer et votre pays / région — fuseau horaire, devise, indicatif téléphonique et transporteurs sont préréglés en conséquence.
Créez votre compte administrateur et saisissez votre clé d’activation (voir section 5).
Contenu d’exemple : laissez la case cochée pour démarrer avec un site complet — slider, services, projets, produits, blog et FAQ en dix langues. Les sites sectoriels sont fournis avec de vraies photos (licence Pexels, usage commercial autorisé), le site informatique avec des illustrations originales. Conservez, modifiez ou supprimez chaque élément plus tard dans le panneau d’administration — ou décochez la case pour démarrer avec un site vide.
Une fois l’assistant terminé, supprimez le dossier install de votre serveur et conservez une copie de sauvegarde de app/config.php — il contient la clé qui chiffre les données personnelles.

5. Activer votre licence

Activation en ligne : pendant l’installation, l’assistant envoie votre clé, votre domaine et la version du logiciel à notre serveur de licences. La clé est ensuite liée au domaine sur lequel le site est installé (avec ou sans www ; tout autre sous-domaine nécessite sa propre licence).
Code d’activation manuelle : si votre serveur ne peut pas accéder à Internet (par exemple parce qu’un pare-feu bloque les connexions sortantes), l’assistant affiche le champ « Code d’activation manuelle ». Envoyez-nous votre numéro de commande et votre domaine via le formulaire de contact ; vous recevrez un code valable uniquement pour cette clé et ce domaine.
Un domaine par licence : chaque licence n’est valable que pour un seul domaine et ne peut pas être transférée vers un autre domaine. Pour un autre site, il vous faut une nouvelle licence.
La clé d’activation est émise pour le domaine indiqué lors de la commande et ne fonctionne que sur celui-ci (avec ou sans www). Le site ne peut pas être installé sur localhost ou d’autres adresses locales — installez-le directement sur votre domaine.

6. Premiers pas dans le panneau d’administration

Connectez-vous sur votre-domaine/admin et suivez la liste de contrôle de l’installation du tableau de bord :

Informations de l’entreprise (mentions légales), logo, couleur de marque et thème de mise en page
Options de livraison et vos coordonnées bancaires pour les virements
Modèles de pages légales — vérifiez-les et adaptez-les à votre activité
Remplacez les textes et photos d’exemple par les vôtres et désactivez les modules dont vous n’avez pas besoin

7. E-mail (SMTP) et vérification en deux étapes

Ouvrez Paramètres du site → E-mail, saisissez le serveur SMTP, le port (587 avec STARTTLS ou 465 avec SSL), le nom d’utilisateur, le mot de passe et l’adresse d’expéditeur de votre boîte mail, puis cliquez sur M’envoyer un test. Gmail et Microsoft 365 exigent un mot de passe d’application. Les envois échoués sont listés avec l’erreur dans le journal d’envoi sous Notifications par e-mail.
Dès que les e-mails de test arrivent, activez la vérification en deux étapes sous Mon profil : chaque connexion est alors confirmée par un code à 6 chiffres envoyé à votre adresse e-mail. Conservez en lieu sûr les dix codes de récupération, qui ne s’affichent qu’une seule fois.

8. Pro uniquement : paiement en ligne par carte

Ouvrez Admin → Paiement en ligne, choisissez PayTR ou Stripe et saisissez les clés API de votre compte prestataire (elles sont stockées chiffrées). Laissez le mode test activé pour l’instant.
PayTR : saisissez l’URL de notification indiquée sur cette page dans votre espace marchand PayTR. Stripe : ajoutez l’URL de webhook qui y est indiquée et collez le secret de signature (whsec_…).
Sous Options de livraison, cochez « Paiement en ligne par carte » pour les options où les clients peuvent payer par carte.
Passez une commande de test, puis désactivez le mode test et saisissez vos clés de production. Les données de carte sont saisies uniquement sur la page sécurisée du prestataire et ne parviennent jamais à votre site.

9. Passer à une nouvelle version

Vos contenus, réglages, traductions, commandes et votre clé d'activation sont stockés dans la base de données et dans app/config.php — une mise à jour ne remplace que les fichiers du programme. Votre licence reste la même ; aucune nouvelle activation n'est nécessaire.

Avant de commencer

Dans le panneau d'administration, ouvrez Licence : la ligne *Version du logiciel* indique la version actuellement installée. Lisez la section « Nouveautés » du fichier INSTALL.md / KURULUM.md du nouveau package.
Téléchargez le nouveau package avec votre lien de téléchargement personnel. Si le lien a expiré, envoyez-nous votre numéro de commande via le formulaire de contact et vous recevrez un nouveau lien. Utilisez toujours le même site web (même secteur) et la même édition (Standard ou Pro) — ou le package Pro pour passer de Standard à Pro.
Faites une sauvegarde : exportez la base de données (phpMyAdmin → Exporter, ou la fonction de sauvegarde de votre hébergeur) et téléchargez par FTP le fichier app/config.php ainsi que le dossier uploads. app/config.php contient la clé qui chiffre les données personnelles — sans elle, ces données ne pourront plus être lues. Une copie complète du dossier du site est encore préférable.
Si vous avez modifié vous-même des fichiers du programme, notez lesquels : la nouvelle version les écrase, et vous devrez ensuite réappliquer vos modifications.

Mise à jour

Décompressez le nouveau fichier ZIP sur votre ordinateur.
Transférez par FTP le contenu du dossier upload dans le même dossier qu'auparavant et autorisez le logiciel FTP à écraser les fichiers existants (y compris les fichiers cachés .htaccess). Ne supprimez d'abord rien sur le serveur. Le package ne contient ni app/config.php ni aucune de vos images : vos réglages et le dossier uploads restent donc tels quels.
Supprimez à nouveau le dossier install du serveur.
Ouvrez votre site web et connectez-vous au panneau d'administration : la base de données est mise à jour automatiquement lors de la première visite (cela prend quelques secondes). Sous Licence, le nouveau numéro de version s'affiche désormais.

Vérifications ensuite

Ouvrez la page d'accueil et quelques pages dans chaque langue active ; envoyez une fois le formulaire de contact.
Pro : effectuez un paiement test dans le mode test de votre prestataire de paiement, ou vérifiez les réglages de paiement.
La mise en page semble ancienne ou cassée ? Rechargez la page avec Ctrl + F5 et videz le cache de votre hébergeur ou de votre CDN (p. ex. LiteSpeed Cache, Cloudflare).
Les nouvelles langues d'une mise à jour sont ajoutées désactivées — activez-les dans le panneau d'administration sous Langues si vous le souhaitez.

En cas de problème

Page blanche ou erreur 500 : consultez le fichier le plus récent dans storage/logs — l'erreur y est décrite.
Pour revenir à la version précédente, restaurez à la fois les fichiers et la base de données à partir de votre sauvegarde. N'utilisez jamais d'anciens fichiers du programme avec une base de données déjà mise à jour.

10. Nginx

Apache et LiteSpeed utilisent les fichiers .htaccess fournis. Sous Nginx, ajoutez ces règles au bloc server de votre domaine (adaptez le socket PHP-FPM à votre serveur) :

location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ ^/(app|storage)(/|$) { deny all; }
location ~ ^/install/(?!index\.php$).+\.php$ { deny all; }
location ~ ^/uploads/.*\.(php|phtml|phar|pl|py|cgi|sh)$ { deny all; }
location ~ /\. { deny all; }
location ~* \.(sql|md|log|lock|ini|bak|old|orig|sh|dist|env|json|yml|yaml|key|pem|zip|tar|gz)$ { deny all; }
location ~ \.php$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass unix:/run/php/php8.2-fpm.sock; }

11. Mode démo

Pour présenter le site à des clients ou collègues sans aucun risque, définissez 'demo' => true dans app/config.php. Les visiteurs peuvent alors explorer l’intégralité du panneau d’administration avec un compte de démo, mais rien n’est enregistré, la vérification en deux étapes est masquée et le contenu se réinitialise automatiquement (intervalle : demo_reset_minutes). La documentation du package liste tous les paramètres de démo.

12. Dépannage

Toutes les pages sauf la page d’accueil affichent une erreur 404 : le fichier .htaccess n’a pas été téléversé ou mod_rewrite est désactivé.
Le site redirige vers une autre adresse : corrigez base_url dans app/config.php.
Aucun e-mail n’arrive : vérifiez les paramètres SMTP et lisez l’erreur dans le journal d’envoi.
Page blanche ou erreur 500 : consultez les fichiers dans storage/logs.

Des difficultés avec l’installation ? Une aide à l’installation est disponible via notre service d’installation payant : commandez-le sur la page des tarifs — ou ajoutez-le lors de la commande — et nous installons le site sur votre hébergement pour vous.