Skip to content
Sébastien Lemay edited this page Jun 27, 2013 · 4 revisions

Bienvenu sur la page Wiki de STPIAdmin.

 STPIAdmin is free software: you can redistribute it and/or modify it
 under the terms of the GNU General Public License version 3 as published
 by the Free Software Foundation. STPIAdmin is distributed in the hope that
 it will be useful, but WITHOUT ANY WARRANTY; without even the implied
 warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 See the GNU General Public License for more details. [http://www.gnu.org/licenses/gpl-3.0.txt GPLv3]

Ici vous trouverez, éventuellement, de la documentation pour installer et utiliser STPIAdmin.

Table of Contents

Contact

Pour toutes questions, commentaires, demandes de support, ... contactez:

Ou utilisez les Issues de GitHub:

Information

STPIAdmin est, une section d'administration pour le contenu d'un site web (CMS). La traduction de la section d’administration est présentement disponible en anglais et français et permet de maintenir un site multilingue. Les textes de la section publique du site sont traduits en anglais, français et espagnol et la section admin est configurée pour ces langues. Il serait possible d'ajouter autant de langues que nécessaire ou d'en enlever. La programmation est en PHP Orienté Objets avec une base de données MySQL. Les page généré sont toutes XHTML valide avec du JavaScript (AJAX). La section d'administration permet d'ajouter des nouvelles, messages du jour, liens, événements en plus de gérer l'inventaire d'une boutique en ligne (types d'item, catégories d'items, prix, ...) et permet de voir les statistiques des commandes effectué sur le site. Vous pouvez aussi créer autant de pages que vous voulez à travers la section d'administration. Il est possible de configurer des usagers avec des droits d'accès différents. Sur le site publique, les clients peuvent se créer un compte, créer une liste de cadeaux, magasiner dans une liste de cadeaux ou faire des achats. Le site peut facilement être sécurisé avec SSL. La section publique peut être modifier directement dans les fichiers PHP pour différentes utilisation en avec les fonctions disponibles pour accéder à l'information dans la base de données. La programmation OO permet d'ajouter facilement des nouvelles fonctionnalités.

Utilisation

Site public

par défaut, contient les pages (sections) suivantes

  • index.php
    • splash screen d’accueil
  • home.php
    • affiche les 2 dernières nouvelles à droite, les bannières de type Accueil à gauche et les catégories d'items au centre
  • shop.php
    • affiche toutes les catégories d'item, types d'item, les items et les sous-items
    • donne accès à toutes les pages de la boutique en ligne
  • registre.php
    • permet d'accéder au registre de cadeaux existant
  • event.php
    • affiche tous les types d'événements et les événements qui ne sont pas passés
  • about.php
    • page statique
  • contact.php
    • affiche formulaire de contact en ligne
  • liens.php
    • affiche tous les types de liens et les liens
  • login.php
    • permet aux clients qui ont un compte de ce connecter
    • connecté, le client peut créer des registres et voir ces commandes
  • register.php
    • permet aux clients de se créer un compte

Section STPIAdmin

La section admin du site est disponible à l'URL: http://.../stpiadmin/

  • user: admin
  • pass: password
Voici une petite description des différentes sections:

Bannières et Liens

Une bannière doit être d'un certain type. Le type doit exister avant de créer la bannière. Quand on clique sur Bannière dans le menu, les 2 premiers champs sont pour chercher parmi les types de bannière et les bannières. Si vous entrez un %, tous les résultats (max 10) seront affichés. Ensuite, vous avez les formulaires pour créer un type de bannière ou une bannière. Les bannières du type Accueil sont affichées sur la page d'accueil, les autres types ne sont pas affichés par les pages du site.

Les liens de tous les types sont affichés sur la page liens.

Clients

La section clients permet de chercher un client par son nom et d'éditer son information. Vous pouvez aussi créer un nouveau client. Ce qui est équivalent à le créer à partir du site web. Si vous choisissez un client, vous pourrez voir ces commandes et ces registres, s’il en a.

Commandes

La section commande permet de chercher et de modifier les Types de commande, Statuts de commande, Méthodes de payement et Types d'adresse. Ensuite vous avez les formulaires pour créer un Type de commande, Statut de commande, Méthode de payement et Type d'adresse.

Seulement les types de commande Registre et Site web sont utilisés par les pages du site. Même chose pour les types d'adresse Facturation et Livraison. Mais vous pourriez en créer et les utiliser dans STPIAdmin.

Une commande qui vient juste d'être faite a un statut de Confirmé par le client. Les autres statuts peuvent être utilisé dans stpiadmin lorsque vous éditez une commande.

Les méthodes de payement sont utilisées pour donner le choix au client lorsqu'il passe une commande.

Événements

La section événements permet de chercher et de modifier les Types d'événement, Adresses et Événements. Ensuite vous avez les formulaires pour créer un Type d'événement, Adresse et Événement. Le type et l'adresse doivent exister avant de créer l'événement. Un événement peut avoir plusieurs date/heure de début/fin. Les Événements de tous les types sont affichés sur la page Événements

Expédition

Pour qu'un pays soit disponible dans les menus du site, il doit faire partie d'une zone d'expédition. Les unités font référence aux unités d'envoi d'un sous item.

Items

Permet de créer tous les éléments nécessaires pour les items.

Niveaux de sécurité

Permet de modifier les droits d'accès pour un niveau. Présentement, il y a 2 niveaux. Celui pour les clients qui ont accès aux sections publiques et les admins qui ont accès à tout le reste. Les clients sont toujours du type Client. Lorsque vous créez un nouvel utilisateur de STPIAdmin vous devez choisir un niveau.

Pour plus de sécurité, il faudrait probablement un autre niveau qui n'aurait pas le droit de créer ou de modifier les utilisateurs.

Utilisateurs de STPIAdmin

Permet de chercher et de modifier l'information sur les utilisateurs. Vous pouvez aussi créer des nouveaux utilisateurs.

Votre mot de passe

Pour changer le mot de passe de votre utilisateur.

J'espère que ça va vous aider pour votre exploration. Si vous trouvez des erreurs, laissez nous savoir.

Installation

Télécharger STPIAdmin ici.

STPIAdmin fonctionne bien sur une architecture LAMP (Linux-Apache-MySQL-PHP).

  1. Pour installation sur Debian et Ubuntu Vous avez besoin des packages suivant : apache2, libapache2-mod-php5, php5, php5-gd, php5-mysql, mysql-server
  2. Extraire les fichiers sur votre serveur web et vérifier que l'utilisateur du serveur peut lire les fichiers et répertoires.
  3. Créer une base de données et un utilisateur pour cette base de données.
  4. Importer le contenu du fichier (install/stpiadmindb.sql) dans la base de données pour créer les tables et les données initiales.
  5. Modifier l'information d'accès à la base de données dans le fichier: stpiadmin/includes/classes/bdd/clsbdd.php
  6. Modifier le nom de l'entreprise, les courriels et la page d'acceuil dans le fichier: stpiadmin/includes/includes.php

Avec la ligne de commande

Préparer le serveur

aptitude install apache2 libapache2-mod-php5 php5 php5-gd php5-mysql mysql-server

Télécharger

wget https://github.com/smellems/stpiadmin/archive/master.zip

Extraire les fichiers



Établir une connexion à MySQL avec root

mysql -u root -p

Créer la base de données et l'utilisateur

CREATE DATABASE stpiadmindb;
GRANT ALL ON stpiadmindb.* TO stpiadmindb@localhost IDENTIFIED BY 'password';
QUIT;

Modifier les fichers

  • ../stpiadmin/includes/classes/bdd/clsbdd.php
  • ../stpiadmin/includes/includes.php

Erreurs

Il semble que si le serveur utilise mod_security, vous ne pourrez pas utiliser le caractère % dans les champs de recherche de la section privé de STPIAdmin. Vous receverez une erreur 406 "an appropriate representation of the requested resource could not be found on this server".

Solution

  • Contacter votre hébergeur pour demander qu'ils corrigent le problème. (C'est possible!)
  • Ajouter au fichier .htaccess (à essayer)
 <IfModule mod_security.c>
  SecFilterEngine Off
  SecFilterScanPOST Off
 </ifmodule>

Nombre de langue

  • Modifier les langues disponible en modifiant le contenu de la table stpi_Lang dans la base de données.
    • Vous pouvez ensuite ajouter les fichier textes manquants.
    • Les champs nécessaires seront ajusté automatiquement dans STPIAdmin.

Affichage

  • Les fichiers PHP de la section publique et le CSS peuvent être modifier avec les images.
    • Les objets permettent l'accès à l'information dans la base de données.
  • Modifier les fonctions commencent par "stpi_affPublic" dans les fichiers (classes) dans le dossier ../stpiadmin/includes/classes/content/
    • Modifier les fichiers textes si nécessaire.
  • Modifier les fonctions commencent par "stpi_affPublic" dans les fichiers (classes) de chaque section nécessaire (news, motd, items, ...)
    • Modifier les fichiers textes si nécessaire.

SSL

Pour activer les redirections vers SSL (https) décommenter tous les instructions de la fonciton stpi_pageEncrypted dans le fichier:

  • ../stpiadmin/includes/classes/security/clslock.php