Scout Web Portail, le moteur de site internet scout

Présentation du Scout Web Portail

  1. Préambule
  2. Présentation
  3. Licence
  4. Installation du portail
    1. Configuration requise
    2. Procédure d'installation
    3. Configuration initiale
    4. Design et Templates
  5. Sauvegarde des données et réinstallation
    1. Sauvegarde des données
    2. Réinstallation à vide
    3. Réinstallation depuis une sauvegarde
  6. Mise à jour du portail
    1. Avant toute mise à jour
    2. Mise à jour de la version 1.0.x à 1.1
    3. Modules personnalisés et version 1.1
  7. Désinstallation
  8. Problèmes
  9. Dons
  10. Participer à l'amélioration de SWP
  11. Contact
  12. Historique des versions

1. Préambule

Scout Web Portail porte bien son nom; c'est un portail internet spécialisé dans les groupes scouts, doté de tous les outils essentiels à cette fonction. Inspiré de loin par les projets Wiki et phpBB, le SWP est le fruit de deux ans de développement par Christian Mattart.

Pourquoi Scout Web Portail ? Eh bien parce que...

Aujourd'hui, il est offert à la communauté afin de simplifier le travail de mise à jour des différents sites d'unité qui choisiront le portail SWP.

Nous espérons que son utilisation vous satisfera en tous points; n'hésitez pas à nous signaler tout bug que vous rencontreriez.

A l'heure actuelle, aucune documentation n'existe pour le portail. Il a été testé pendant ses deux années de développement et normalement, la plupart des bugs ont été éradiqués et les outils disponibles parlent d'eux- mêmes. Cependant, en fonction du succès rencontré par le portail, une documentation sera probablement rédigée. Avis aux amateurs !

Comme aucune documentation n'existe, lisez attentivement ce fichier avant de passer à l'installation proprement dite.

Le portail est distribué sous licence GNU GPL, ce qui vous offre toute la flexibilité requise dans l'adaptation du portail à votre groupe scout. Si vous apportez des améliorations significatives au portail, n'hésitez pas à les partager avec la communauté sur ce site !

2. Présentation du Scout Web Portail

SWP est un portail web spécialement destiné aux groupes scouts.

Tout est prévu sur le portail pour simplifier la vie du webmaster et des animateurs qui s'occupent de la mise à jour des informations sur le site.

Chaque animateur peut gérer lui-même les pages web de sa section. La gestion du portail est entièrement collaborative.

Le tout se fait très simplement comme sur un forum internet ou, si l'animateur le souhaite, au format html.

D'autres personnes peuvent également rédiger les pages du site, sans pour autant être animateur. Un statut de co-webmaster peut être attribué à des membres du portail, ce qui leur donne accès la gestion des pages du site et des albums photos, mais pas à la gestion des membres de l'Unité [synthèse des droits d'accès].

De plus, SWP offre un espace d'échange, autant public que réservé aux staffs. Un tout nouveau forum a été développé pour renforcer la qualité des échanges dans un lieu unique à la gestion simplifiée. Il est possible de créer un grand nombre de forums et d'autoriser les accès et la modération selon vos préférences. De cette manière, chacun des staffs et chacune des sections peut discuter à son aise dans un espace qui lui est réservé.

Les albums photos permettent de rassembler tous les albums de l'Unité. Chaque animateur ou co-webmaster peut créer des albums photos pour les sections très simplement. Les photos, déposées par les personnes autorisées, sont redimensionnées automatiquement au format web par le portail.

Une nouveauté, encore jamais vue ailleurs, est la possibilité de créer des albums photos distants. Le portail ne contient que la farde. Les photos sont stockées sur un autre site web ! La création d'albums distants peut être faite automatiquement si vous disposez d'un accès FTP au site où sont stockées les photos, ou manuellement.

Le lieu d'échange que forme le Scout Web Portail permet de renforcer la communication entre animateurs et entre staffs rendue difficile par le fait que, bien souvent, une partie des animateurs n'est pas disponible durant la semaine.

Plus encore, les pages à accès restreint permettent de conserver une trace écrite des comptes-rendus de réunions de staff ou d'unité.

Le second outil essentiel pour un groupe scout est sa Gestion des membres. Tous les outils sont disponibles pour vous faciliter la vie dans la gestion quotidienne des Unités et des Sections : passages, cotisations, changements d'adresse, double adresse, liste d'attente, sizaines et patrouilles, publipostage pour réduire les frais de courrier, listings membres, listings photos pour retenir facilement les visages des nouveaux.

L'avantage primordial de cet outil est le fait que toutes les données sont accessibles à tout moment par les animateurs. Et si le portail devient le centre de votre gestion des membres, il contiendra les données les plus à jour à tout instant.

En relation avec la législation sur la protection de la vie privée, les données des membres ne sont pas accessibles au public. Les animateurs doivent s'inscrire et être reconnus par d'autres animateurs déjà présents sur le portail avant de pouvoir accéder à ces données. A l'inscription, les membres s'engagent à ne pas divulguer les données à
caractère privé auxquelles ils pourraient avoir accès sur le portail.

Il reste encore de nombreuses fonctions à présenter, mais l'essentiel est dit.

3. Licence d'utilisation

Le Scout Web Portail est publié gratuitement sous licence GNU GPL. Référez-vous au fichier licence.txt pour plus d'infos.

Ceci signifie que vous pouvez utiliser gratuitement ce script, le modifier pour votre usage propre. Si vous en distribuez une version modifiée, elle doit elle-même suivre les termes de la licence GPL.

L'AUTEUR NE POURRAIT EN AUCUN CAS ETRE TENU POUR RESPONSABLE DES PROBLEMES QUI POURRAIENT RESULTER DE L'UTILISATION DE CE SCRIPT OU DE L'UNE DE SES VERSIONS DERIVEES.

La GNU GPL : http://www.gnu.org/

4. Installation du portail

  1. Configuration requise
  2. Procédure d'installation
  3. Configuration initiale
  4. Design et Templates

Mise à jour du portail

Une section de ce document est consacrée à la mise à jour d'une ancienne installation du portail.

4.1. Configuration requise

Pour installer le portail, vous devez disposer d'un serveur web acceptant :

Nous conseillons également que le serveur web accepte :

l'url-rewriting

Cette fonction permet d'utiliser des adresses plus parlantes pour l'utilisateur. Exple : index.php?niv=g&page=forum&fil=12 devient fil12.htm

Si vous ignorez si l'url-rewriting est actif sur votre espace web, activez-le à l'installation et testez le fonctionnement du site. S'il ne fonctionne pas, vous pourrez le désactiver depuis la page de configuration du portail après avoir supprimé le fichier .htaccess du dossier principal du portail.

la fonction mail() native de php

A l'heure actuelle, nous n'avons pas implémenté de fonction mail() modifiée. Lycos et Free notamment, ont modifié cette fonction avec leurs propres paramètres. A l'installation, vous pouvez choisir d'activer ou non la fonction mail() sur le site. Ce choix peut être modifié par la suite depuis la page de configuration du portail.

Si nécessaire, vous pouvez adapter le script de gestion des emails. Il se trouve dans le fichier prv/emailer.php qui est une adaptation de la classe d'envoi de mails proposée par le groupe PHPbb.

4.2. Procédure d'installation

Pour installer le portail sur votre site web, un programme d'installation est à votre disposition. Suivez simplement les instructions ci-dessous ainsi que sur les pages correspondantes.

A. Transférez d'abord l'entièreté des fichiers du portail sur votre site web.

B. Afin de permettre au portail d'écrire des fichiers sur le serveur, modifiez les droits en écriture des dossiers suivants :

Sans cela, les outils concernés renverront des messages d'erreur.

C. Ouvrez-votre navigateur et rendez vous à l'adresse où vous avez placé le portail (exple : http://www.votresite.org/ ). Le portail vous redirigera automatiquement vers le programme d'installation.

D. Remplissez simplement le formulaire avec les données adéquates. Pour l'url-rewriting et la fonction mail(), référez-vous à la configuration requise.

4.3. Configuration initiale

Une fois l'installation effectuée, vous arrivez sur la page d'accueil du portail.

A. Connectez-vous à votre compte de webmaster.

B. Le portail vous propose de créer une Unité, base du fonctionnement du portail. Une section anciens sera automatiquement créée pour cette unité. Vous pouvez créer autant d'unités que vous souhaitez si votre groupe scout en compte plusieurs (à l'origine, le groupe scout d'Andenne, pour lequel a été créé le portail, regroupe une unité guide et une unité scoute).

C. Après avoir créé l'unité, ajoutez-y les sections.

D. Dans la page de Gestion des Sections, vous pouvez activer les espaces web des sections pour afficher leur nom dans le menu du portail.

E. Maintenant que les espaces web des sections sont activés, vous pouvez ajouter des liens dans leurs menus. Si les liens que vous créez mènent vers des pages inexistantes, il vous sera proposé de les créer. Simple, non ?

F. Afin de permettre à d'autres membres de s'inscrire sur le portail, créez des statuts de membres. Créez un statut d'animateur de section et d'animateur d'unité pour chaque section et unité de la base de données (animateur baladin, animateur louveteau, ...) et liez ces statuts à leur section respective. Ensuite, vous pouvez créer d'autres statuts (Membre de l'Unité, baladin, scout, nuton, guide, parent de scout, parent de baladin, ancien scout, ... à votre goût).

Note : Les statuts visiteur et webmaster sont protégés contre les modifications.

G. Ensuite, vous pouvez configurer un tas de détails pour le portail depuis la page de configuration du portail.

4.4. Design et templates

Le design du portail repose uniquement sur les feuilles de styles CSS.

Nous vous suggérons de vous plonger dans les fichiers de styles du portail qui se trouvent dans le dossier templates/default/ Vous pouvez les modifier afin d'y apporter votre touche personnelle.

Normalement, les noms des classes sont clairs et les styles sont organisés selon la structure du portail. Divers commentaires éclaircissent parfois certains points.

En attendant, il vous reste à étudier les styles CSS (Google est votre ami). Il n'y a rien de bien compliqué...

Ayons d'ailleurs une pensée émue pour les pauvres webmasters condamnés à créer des styles spécifiques à Microsoft Internet Explorer, si particulier dans son interprétation en si bémol des styles CSS.

5. Sauvegarde des données et réinstallation

  1. Sauvegarde des données
  2. Réinstallation à vide
  3. Réinstallation depuis une sauvegarde

5.1. Sauvegarde des données

Nous vous conseillons d'effectuer fréquemment une sauvegarde des données du portail. Pour ce faire, voici les éléments à sauvegarder :

5.2. Réinstallation à vide

Réinstaller le portail pour lui donner une seconde jeunesse en le vidant de son contenu.

En admettant que les fichiers du portail soient toujours présents d'une installation précédente du portail.

5.3. Réinstallation depuis une sauvegarde

Si, pour une raison ou une autre, vous souhaitez réinstaller le portail et que vous souhaitez récupérer vos données d'une installation précédente, assurez-vous d'avoir à votre disposition les fichiers mentionnés ci-dessus dans la section "Sauvegarde des données " de ce chapitre.

6. Mise à jour du portail

  1. Avant toute mise à jour
  2. Mise à jour de la version 1.0.x à 1.1
  3. Modules personnalisés et version 1.1

6.1. AVANT TOUTE MISE A JOUR

Avant de commencer la procédure de mise à jour du portail, faites une SAUVEGARDE COMPLETE afin de récupérer les données en cas de problème.

Pour rappel et conformément à la licence GPL, aucune garantie n'est donnée sous quelque forme que ce soit quant à la fiabilité et à la sécurité du logiciel. Et aucun support ne sera fourni pour récupérer une installation endommagée en l'absence de sauvegarde complète.

6.2. Mise à jour de la version 1.0.x à 1.1

Afin de garantir une mise à jour correcte, nous vous conseillons de suivre
les étapes ci-dessous :

  1. Si vous avez personnalisé les styles du portail, gardez une copie des fichiers CSS. En effet, la version 1.1 apporte d'énormes modifications au niveau du design.
  2. Uploadez l'ensemble des fichiers de la version 1.1 et écrasez les anciens.
  3. Lancez le script de mise à jour.

Etant donné la quantité de modifications apportées au portail, des fichiers ont été renommés, supprimés, scindés, ...

Le script de mise à jour effectue plusieurs opérations :

Pour plus d'informations, voyez les notes de version.

* Les fichiers obsolètes sont les suivants :

Les anciennes tables des forums à supprimer sont les suivantes :

6.3. Modules personnalisés et version 1.1

La principale évolution du portail pouvant influencer les modules publiés à l'heure actuelle sur le portail est la nouvelle bibliothèque de styles.

Les auteurs respectifs des différents modules sortiront probablement une version adaptée de ceux-ci, n'hésitez pas à vous tenir au courant en visitant régulièrement le site du Scout Web Portail ou en consultant le fil rss de SWP.

7. Désinstallation

Pour désinstaller le portail, il suffit de supprimer tous les fichiers de ce dossier et toutes les tables du portail dans la base de données.

Si la désinstallation vise à réinstaller le portail, voir la section précédente du fichier lisez-moi.html.

8. Problèmes connus

Impossible de se connecter

En cas de problèmes de connexion.

Erreur 500 (internal server error)

Si vous avez activé l'url-rewriting à l'installation et qu'il n'est pas activé sur le serveur de votre site, une erreur 500 (internal server error) se produit à chaque chargement de page. Pour résoudre ce problème :

Téléchargement impossible

Les erreurs constatées au téléchargement jusqu'à présent étaient causées par le serveur et non par SWP. Mais toute information est la bienvenue.

Upload de fichiers

Il se peut que l'upload de fichiers par protocole HTTP soit interdit, ou que la taille du fichier dépasse la taille autorisée.

Dans ce cas, choisissez un fichier de plus petite taille ou vérifiez que l'upload de fichiers est bien activé pour votre hébergement.

Upload de photos / Redimensionnement

Les photos déposées sur le portail sont redimensionnées à l'aide de la librairie de fonction GD2. Si elle n'est pas chargée sur votre site, l'upload de photos pour les galeries est impossible. Vous devrez les déposer sur le serveur par FTP après les avoir redimensionnées manuellement.

Impossible de lire ou d'écrire dans un dossier

Vérifiez que vous avez correctement paramétré les droits d'accès du dossier concerné. La configuration de certains serveurs n'autorise pas la modification des droits d'accès aux fichiers/dossiers et certaines erreurs peuvent se produire.

Autre problème

Si vous êtes confronté à un autre problème, faites une recherche sur le forum du portail, d'autres utilisateurs y ont peut-être déjà été confrontés.

Si vous ne trouvez aucune réponse, consultez le site consacré aux bugs et aux suggestions et signalez votre problème.

9. Dons

Ces deux dernières années, l'auteur a consacré une très grosse partie de son temps libre à la création et à l'amélioration de ce portail. Faire fortune n'est
certainement pas l'objectif poursuivi avec la publication de ce portail.

Le don est une forme de remerciement, d'encouragement à continuer le développement de nouveaux outils et à corriger les bugs découverts. D'autre part, l'hébergement du site internet et les frais qui l'entourent peuvent être amortis à l'aide de vos dons. Les montants excédentaires seront donnés à des oeuvres caritatives oeuvrant pour l'aide à la jeunesse.

Si vous souhaitez faire un don sous une autre forme que de l'argent contactez l'auteur via le site du portail.

Vous pouvez verser le montant que vous souhaitez.

10. Participer à l'amélioration du portail

Si vous appréciez le portail et que vous souhaitez nous aider à le promouvoir et à le développer, soyez le bienvenu !

Les prochaines améliorations du portail toucheront essentiellement à :

11. Contact

Avant de me contacter, consultez utilement le forum pour voir si votre question n'a pas déjà été posée. Si ce n'est pas le cas, inscrivez-vous sur le portail et posez votre question sur le forum.

12. Historique des versions

L'historique des versions est disponible

Page générée en 0.08 secondes (3 requêtes)