Documentación PIXMARO / Instalación

📦 Instalación

Instala PIXMARO en tu propio alojamiento.

Traducción en curso
Esta página aún no está traducida a tu idioma. Te la mostramos en francés.

Vous avez acheté PIXMARO pour l'installer sur votre propre serveur. Cette partie couvre ce que la version Cloud vous éviterait : mettre les fichiers en place, activer votre licence, et régler l'hébergement.

Comptez un quart d'heure, sans compétence particulière. L'installeur vérifie lui-même votre serveur et vous dit quoi corriger s'il manque quelque chose. Tout le reste de la documentation — albums, templates, Lightroom, portail client — s'applique ensuite à l'identique.

Requisitos del servidor

PIXMARO est conçu pour tourner sur un hébergement mutualisé ordinaire. Pas de serveur dédié, pas d'accès root, pas de Docker, pas de Node.js, pas de MySQL. Si votre hébergement fait tourner un WordPress, il fera tourner PIXMARO.

La liste exacte

Ce qu'il fautDétailSi ça manque
PHP 8.2 ou plus récentLa plupart des hébergeurs proposent 8.2 à 8.4.Changez la version PHP dans votre panneau d'hébergement — c'est un réglage, pas un déménagement.
PDO et PDO SQLiteLa base de données de PIXMARO est un simple fichier.Bloquant. À demander à votre hébergeur.
GDFabrique les vignettes et applique le filigrane.Bloquant.
mbstringGère les accents et les caractères spéciaux.Bloquant.
fileinfoReconnaît le type réel des fichiers envoyés.Non bloquant, mais vivement recommandé.
zipSert aux téléchargements groupés et aux sauvegardes complètes.PIXMARO s'installe sans, mais vos clients ne pourront pas tout télécharger d'un coup.
mod_rewrite (Apache)Donne des adresses propres du type /albums. Actif par défaut presque partout.Non bloquant : sans lui, PIXMARO bascule seul sur des adresses de la forme index.php?r=/albums, et tout fonctionne. Voir ci-dessous pour Nginx.
50 Mo d'espace disquePour PIXMARO lui-même.Vos photos viennent en plus — c'est elles qui compteront.
Bueno saberlo

Vous n'avez rien à vérifier vous-même : l'installeur contrôle tous ces points en première page et vous dit précisément ce qui manque, avec la marche à suivre.

Apache, LiteSpeed, Nginx

Sur Apache et sur LiteSpeed — la très grande majorité des hébergements mutualisés — il n'y a rien à faire : le fichier .htaccess livré avec PIXMARO règle tout, les adresses et la protection des dossiers.

Sur Nginx, qui ne lit pas les .htaccess, l'installation se déroule normalement : PIXMARO le détecte et passe seul en adresses de secours. Une chose reste à faire, et elle est importante : protéger le dossier de la base de données. Ajoutez cette règle à la configuration de votre site, puis rechargez le serveur :

location ^~ /data/ {
    return 404;
}
Atención

Sans cette règle, votre base de données est téléchargeable par toute personne qui en devine l'adresse. Elle contient les adresses email de vos clients, les empreintes de leurs mots de passe, votre clé d'API et les liens d'accès à tous vos albums.

PIXMARO vérifie ce point tout seul : il vous le signale à la fin de l'installation, et à tout moment dans Paramètres → À propos → Diagnostic système. Si votre hébergeur gère la configuration à votre place, transmettez-lui ces trois lignes.

L'extension Imagick, en option

Si votre hébergeur propose Imagick, PIXMARO l'utilisera automatiquement pour traiter les photos envoyées depuis le navigateur. Il consomme nettement moins de mémoire que GD sur les gros fichiers, ce qui compte dès que vous envoyez des images de 24 ou 45 mégapixels. Rien à activer : PIXMARO le détecte et bascule seul, et retombe sur GD s'il est absent ou capricieux.

Instalar PIXMARO paso a paso

Comptez un quart d'heure, dont l'essentiel en transfert de fichiers.

  1. Téléchargez l'archive depuis votre espace acheteur sur pixmaro.com, et décompressez-la sur votre ordinateur.
  2. Envoyez le contenu par FTP dans le dossier de votre domaine — souvent public_html/, www/ ou un dossier au nom de votre site. Envoyez le contenu du dossier décompressé, pas le dossier lui-même.
  3. Vérifiez que le fichier .htaccess est bien arrivé. Il commence par un point, donc beaucoup de clients FTP le masquent par défaut. Sans lui, PIXMARO s'affiche mal ou pas du tout.
  4. Ouvrez votre domaine dans un navigateur. L'installeur se lance tout seul : tant que PIXMARO n'est pas installé, toutes les adresses y mènent.
  5. Lisez la page de vérification. Tout ce qui est vert est bon. Un point rouge est bloquant et s'accompagne de la marche à suivre ; un point orange est un simple avertissement.
  6. Remplissez le formulaire — nom du studio, votre compte administrateur, adresse du site et fuseau horaire — puis validez.
📷
Première page de l'installeur : la liste des vérifications avec ses pastilles vertes.

Ce que l'installeur vous demande

ChampCe que c'est
Nom du studioLe nom que verront vos clients en haut de chaque galerie. Modifiable ensuite.
Nom, email, mot de passeVotre compte administrateur. Huit caractères minimum. C'est avec cet email que vous vous connecterez.
Adresse du sitePré-remplie et généralement correcte. Vérifiez seulement qu'elle commence par https:// si votre domaine a un certificat.
Fuseau horaireSert à dater les sélections et les téléchargements de vos clients.
J'utilise Lightroom ClassicUne case à cocher. Elle adapte l'interface et crée un second template adapté à la publication depuis Lightroom. Elle se change à tout moment dans les réglages.
LangueLa langue de votre espace d'administration. Vos clients, eux, verront la leur.

Ce que l'installeur fabrique

À la validation, PIXMARO crée la base de données, votre compte administrateur, votre clé d'API (celle du plugin Lightroom, que vous retrouverez dans les réglages) et un template « Standard » déjà réglé : vignettes de 400 px, aperçus de 1800 px, sans filigrane, zoom autorisé. Ces valeurs conviennent à la grande majorité des usages — vous n'avez pas à y toucher pour commencer.

Atención

Si vous déposez PIXMARO dans un sous-dossier (monsite.fr/galeries/), vérifiez que l'adresse proposée par l'installeur contient bien ce sous-dossier. Une adresse fausse ne bloque pas l'installation, mais tous les liens que vous enverrez à vos clients pointeront à côté.

Activar tu licencia

L'installation terminée, connectez-vous, puis allez dans Paramètres → Licence. Saisissez la clé reçue par email à l'achat et l'adresse email de cet achat. PIXMARO contacte pixmaro.com une fois, récupère votre licence, et c'est fini.

Licence et nom de domaine

Votre licence est rattachée au domaine sur lequel PIXMARO est installé. Le préfixe www. et le numéro de port sont ignorés, donc www.monstudio.fr et monstudio.fr comptent pour le même. En revanche, un vrai changement de domaine demande une réactivation — voir plus bas.

Bueno saberlo

Sur localhost et 127.0.0.1, la vérification de domaine est désactivée. Vous pouvez donc monter une copie d'essai sur votre machine sans consommer ni bloquer votre licence.

Standard et Pro : ce qui change

Les deux licences livrent le même logiciel et le même flux de travail : sélection, validation, livraison, plugin Lightroom, et vos données sur votre serveur. Elles se distinguent sur deux points, tous deux visibles par vos clients.

StandardPro
Nom et logoVos pages clients portent le nom PIXMARO.Votre nom de studio et votre logo, et aucune mention de PIXMARO nulle part.
Filigrane automatiqueNon inclusInclus

Le nom de domaine est le vôtre dans les deux cas : c'est votre installation qui le décide, pas votre licence.

Bueno saberlo

Pendant la période d'essai, ces deux fonctions sont actives — vous jugez donc sur pièces avant de choisir votre licence.

Ce qui se passe si la licence expire

C'est la question qui inquiète, et la réponse est rassurante : vos clients ne voient aucune différence. Les galeries restent en ligne, les sélections restent enregistrées, les téléchargements continuent de fonctionner.

Ce qui se fige, c'est votre espace à vous, qui passe en lecture seule :

  • vous ne pouvez plus créer d'album ni envoyer de photos ;
  • les mises à jour ne sont plus disponibles ;
  • vous pouvez toujours consulter tout ce qui existe ;
  • vous pouvez toujours supprimer — vos données restent les vôtres ;
  • la page Licence reste accessible, pour renouveler et repartir.

Une licence à vie ne se fige jamais. Et si votre serveur perd temporairement le contact avec pixmaro.com, PIXMARO continue normalement pendant trente jours avant de s'inquiéter — une coupure réseau ne bloque pas votre travail.

Ajustar el servidor web: HTTPS, tamaño de subida, permisos

Trois réglages d'hébergement méritent un coup d'œil. Aucun n'est propre à PIXMARO, et tous se règlent depuis le panneau de votre hébergeur.

HTTPS — indispensable

Vos clients saisissent parfois un mot de passe et téléchargent des photos privées : le site doit être en https://. Tous les hébergeurs proposent aujourd'hui un certificat gratuit, activable en un clic.

Activez-le avant l'installation si possible : l'installeur détecte l'adresse tout seul, et il enregistrera directement la bonne. Si vous passez en HTTPS après coup, corrigez l'adresse dans Paramètres → Profil & Studio.

Taille maximale d'envoi

C'est le point de friction classique. Un fichier RAW ou un JPEG plein format dépasse souvent la limite par défaut des hébergeurs, généralement fixée entre 2 et 64 Mo. Deux valeurs PHP commandent cela :

upload_max_filesize = 64M
post_max_size = 128M
max_execution_time = 300
memory_limit = 256M

Beaucoup d'hébergeurs les exposent dans leur interface. Sinon, un fichier .user.ini ou php.ini à la racine fait l'affaire — la documentation de votre hébergeur précise lequel.

Bueno saberlo

PIXMARO sait contourner ce plafond : l'envoi par morceaux, activable dans Paramètres → Système, découpe chaque fichier avant de l'envoyer. La limite de l'hébergeur ne s'applique alors plus à la photo entière. C'est la solution à privilégier si vous ne pouvez pas modifier la configuration PHP.

Permissions des dossiers

Trois dossiers doivent être accessibles en écriture : data/ (la base de données), uploads/ (vos photos) et config/. Le réglage habituel est 755 pour les dossiers et 644 pour les fichiers. L'installeur vérifie ces trois dossiers et vous prévient si l'un d'eux résiste.

Sur Apache et LiteSpeed, data/, config/, core/ et modules/ sont bloqués en accès web par le fichier .htaccess livré avec PIXMARO. Sur Nginx, c'est la règle donnée au premier sujet de cette page qui joue ce rôle — et Paramètres → À propos → Diagnostic système vous dit à tout moment si votre base est bien hors d'atteinte.

Mover, reinstalar o cambiar de dominio

Changer d'hébergeur

Le principe est simple : on sauvegarde d'un côté, on restaure de l'autre.

  1. Sur l'ancien serveur : Paramètres → Sauvegarde, puis sauvegarde complète — elle contient la base de données et vos photos. Téléchargez l'archive.
  2. Sur le nouveau serveur : installez PIXMARO normalement, jusqu'à l'écran de connexion.
  3. Connectez-vous, allez dans Paramètres → Sauvegarde et restaurez l'archive.
  4. Corrigez l'adresse du site dans Paramètres → Profil & Studio si le domaine a changé.
  5. Réactivez votre licence dans Paramètres → Licence.
Atención

Gardez l'ancienne installation en ligne jusqu'à ce que la nouvelle soit vérifiée. Tant que le transfert n'est pas confirmé, vos clients continuent d'utiliser l'ancienne adresse — et une galerie coupée pendant une migration, c'est un appel téléphonique.

Changer de nom de domaine

Trois choses sont à reprendre, dans cet ordre :

  1. L'adresse du site, dans Paramètres → Profil & Studio. C'est elle qui fabrique tous les liens.
  2. La licence, à réactiver : elle est rattachée à l'ancien domaine et ne reconnaîtra pas le nouveau.
  3. Le plugin Lightroom, dont l'adresse de service pointe encore vers l'ancien domaine.
Atención

Les liens d'album déjà envoyés à vos clients contiennent l'ancien domaine et cesseront de fonctionner. Prévoyez soit une redirection de l'ancien domaine vers le nouveau, soit un renvoi des liens aux clients dont les albums sont encore ouverts.

Réinstaller par-dessus

Une mise à jour ne se fait pas en réinstallant : PIXMARO se met à jour tout seul depuis Paramètres → Mise à jour. La réinstallation ne sert qu'à repartir de zéro, ou à remonter une installation cassée à partir d'une sauvegarde.

Dans ce cas, ne supprimez jamais data/ ni uploads/ avant d'avoir votre sauvegarde en main et de l'avoir ouverte pour vérifier qu'elle contient bien quelque chose.