Introduction

by Guy Vigneault — last modified 2008-03-23 10:10 Publié ici grâce a l'aimable collaboration de l'équipe PwsPHP

Keywords: PwsPHP

Par zeta

Bienvenue sur la Documentation de pwsphp !

Qu'est-ce que pwsphp ?

Pws-PHP (Portail Web system) est un un CMS (Content Managing System) écrit en PHP (plus précisément compatible PHP 4.0 et supérieur), gratuit, disposant de nombreuses fonctions, necessitant très peu de connaissances en programmation et configurable à 100%. ...
Il a pour vocation d'être entièrement modulable et aisément modifiable.
Ce Portail est distribué sous Licence GNU GPL.

Qu'est-ce que la GNU/GPL ?

Les licences d'utilisation de la plupart des programmes sont définies pour limiter ou supprimer toute liberté à l'utilisateur.
À l'inverse, la Licence Publique Générale (General Public License) est destinée à vous garantir la liberté de partager et de modifier les logiciels libres, et de s'assurer que ces logiciels sont effectivement accessibles à tout utilisateur.

En outre, pour protéger chaque auteur , la GNU/GPL affirme que le programme concerné ne fait l'objet d'aucune garantie.
Si un tiers le modifie puis le redistribue, tous ceux qui en recevront une copie doivent savoir qu'il ne s'agit pas de l'original afin qu'une copie défectueuse n'entache pas la réputation de l'auteur du logiciel.

Vous pouvez copier et distribuer des copies conformes du code source du Programme, tel que Vous l'avez reçu, sur n'importe quel support, à condition de placer sur chaque copie un copyright approprié et une restriction de garantie, de ne pas modifier ou omettre toutes les stipulations se référant à la présente Licence et à la limitation de garantie, et de fournir avec toute copie du Programme un exemplaire de la Licence.

Vous pouvez demander une rétribution financière (ce n'est pas le cas pour pwsphp qui est gratuit) pour la réalisation de la copie et demeurez libre de proposer une garantie assurée par vos soins, moyennant finances
Plus d'infos sur www.gnu.org (en anglais)
ou www.linux-france.org (une adaptation non officielle de la Licence Publique Générale du projet GNU)

Comment marche pwsphp ?

Pwsphp a été écrit en php, il ne fonctionne donc qu'avec ce langage...
Mais Pwsphp utilise aussi une base de donnée MySQL...

Concrètement comment ça marche ?
Lorsque vous rentré l'adresse de votre site pwsphp dans votre navigateur celui ouvre le fichier index.php et execute les instruction et dès les première lignes de codes, est démarrée la connexion à la base de donnée pour récupérer les paramètres.
Ensuite on applique le thème contenu dans la variable $thème, on affiche la colonne de droite puis celle du centre et enfin celle de gauche.

le contenu des colonnes de droite et de gauche est appelé bloc

Au centre ce trouve le module

Qu'est-ce que c'est qu'un bloc ?

Comme dit précédement un bloc est le contenu des colonnes de droite et de gauche.
Ces deux colonnes sont un peu dans le même temps la boite à outils du site ainsi que un ensemble de raccourcis

L'affichage des blocs est entièrement configurable par l'administrateur
De plus il existe une option qui permet d'effacer la colonne de droite sur le site comme pour le forum par exemple

il suffit de mettre dans le fichier du module $aff_drt=1

Qu'est-ce que c'est qu'un module ?

Comme dit précédement un module est le contenu de la colonne du milieu.
c'est la page en cours

celle-ci est si l'adresse est index.php?mod=monmodule est dans dans le dossier modules/monmodule et se nomme index.php

si l'adresse est index.php?mod=monmodule&ac=test est dans dans le dossier modules/monmodule et se nomme test.php

Qu'est-ce que c'est qu'un hack ?

Un hack sur pwsphp c'est une modification d'un fichier déjà créé, le plus souvent posté par un developpeur sur le forum.
Un hack vise toujours à ameliorer le fichier original.
Lorsque le portail change de version c en général parce qu'on a pris en compte les hacks fait par les membres dans un nouvel install.
Cependant on y met aussi de nouveaux modules voire de nouveaux thèmes...

Conclusion

Voilà pour les question général.
Pour tout le reste il y a la documentation
Si vous souhaitez commencer à programmer nous vous conseillons de lire les principes de développement puis les la description des fonctions déjà actives