spip / SPIP

ecrire/inc/puce_statut.php

Doc Comments +5 added lines

@@ -364,6 +364,11 @@
 }
 
 // http://doc.spip.org/@afficher_script_statut
+/**
+ * @param integer $n
+ * @param string $img
+ * @param string $statut
+ */
 function afficher_script_statut($id, $type, $n, $img, $statut, $titre, $act='') {
 	$i = http_wrapper($img);
 	$h = generer_action_auteur("instituer_$type","$id-$statut");

ecrire/inc/securiser_action.php

Doc Comments +10 added lines

@@ -36,6 +36,10 @@ 
 // Attention: PHP applique urldecode sur $_GET mais pas sur $_POST
 // cf http://fr.php.net/urldecode#48481
 // http://doc.spip.org/@securiser_action_auteur
+/**
+ * @param string $action
+ * @param string $arg
+ */
 function securiser_action_auteur($action, $arg, $redirect="", $mode=false, $att='', $public=false)
 {
 	static $id_auteur=0, $pass;
@@ -99,6 +103,9 @@ 
 }
 
 // http://doc.spip.org/@_action_auteur
+/**
+ * @param string $alea
+ */
 function _action_auteur($action, $id_auteur, $pass, $alea) {
 	static $sha = array();
 	if (!isset($sha[$id_auteur.$pass.$alea])){
@@ -169,6 +176,9 @@ 
 }
 
 // http://doc.spip.org/@verifier_cle_action
+/**
+ * @param string $action
+ */
 function verifier_cle_action($action, $cle) {
 	return ($cle == calculer_cle_action($action));
 }

ecrire/inc/selectionner.php

Doc Comments +6 added lines

@@ -58,6 +58,12 @@
 }
 
 // http://doc.spip.org/@construire_selectionner_hierarchie
+/**
+ * @param string $idom
+ * @param string|boolean $racine
+ * @param string $url
+ * @param string $name
+ */
 function construire_selectionner_hierarchie($idom, $liste, $racine, $url, $name, $url_init='')
 {
 	global $spip_lang_right;

ecrire/inc/session.php

Doc Comments +9 added lines

@@ -113,6 +113,9 @@ 
 
 // Ajouter une donnee dans la session SPIP
 // http://doc.spip.org/@session_set
+/**
+ * @param string $nom
+ */
 function session_set($nom, $val=null) {
 	// On ajoute la valeur dans la globale
 	$GLOBALS['visiteur_session'][$nom] = $val;
@@ -123,6 +126,9 @@ 
 
 // Lire une valeur dans la session SPIP
 // http://doc.spip.org/@session_get
+/**
+ * @param string $nom
+ */
 function session_get($nom) {
 	return isset($GLOBALS['visiteur_session'][$nom]) ? $GLOBALS['visiteur_session'][$nom] : null;
 }
@@ -291,6 +297,9 @@ 
 // Calcule le nom du fichier session
 //
 // http://doc.spip.org/@fichier_session
+/**
+ * @param string $alea
+ */
 function fichier_session($alea, $tantpis=false) {
 
 	if (!isset($GLOBALS['meta'][$alea])) {

ecrire/inc/statistiques.php

Doc Comments +34 added lines

@@ -13,6 +13,10 @@ 
 if (!defined('_ECRIRE_INC_VERSION')) return;
 
 // http://doc.spip.org/@aff_statistique_visites_popularite
+/**
+ * @param string $serveur
+ * @param integer $liste
+ */
 function aff_statistique_visites_popularite($serveur, $id_article, &$classement, &$liste){
 	// Par popularite
 	$result = sql_select("id_article, titre, popularite, visites", "spip_articles", "statut='publie' AND popularite > 0", "", "popularite DESC",'','',$serveur);
@@ -139,6 +143,10 @@ 
 }
 
 // http://doc.spip.org/@cadre_stat
+/**
+ * @param string[] $stats
+ * @param string $table
+ */
 function cadre_stat($stats, $table, $id_article)
 {
 	if (!$stats) return '';
@@ -149,6 +157,10 @@ 
 }
 
 // http://doc.spip.org/@statistiques_collecte_date
+/**
+ * @param string $count
+ * @param string $table
+ */
 function statistiques_collecte_date($count, $date, $table, $where, $serveur)
 {
 	$result = sql_select("$count AS n, $date AS d", $table, $where, 'd', 'd', '','', $serveur);
@@ -159,6 +171,10 @@ 
 }
 
 // http://doc.spip.org/@statistiques_tous
+/**
+ * @param string $table
+ * @param string $order
+ */
 function statistiques_tous($log, $id_article, $table, $where, $order, $serveur, $duree, $interval, $total, $popularite, $liste='', $classement=array(), $script='')
 {
 	$r = array_keys($log);
@@ -318,6 +334,10 @@ 
 // Presentation graphique
 // (rq: on n'affiche pas le jour courant, c'est a la charge de la prevision)
 // http://doc.spip.org/@stat_log1
+/**
+ * @param double $agreg
+ * @param string $script
+ */
 function stat_log1($log, $agreg, $date_today, $largeur, $rapport, $interval, $script) {
 	$res = '';
 	$rien = http_img_rien($largeur, 1, 'trait_bas', '');
@@ -365,6 +385,9 @@ 
 }
 
 // http://doc.spip.org/@statistiques_vides
+/**
+ * @param integer $moyenne
+ */
 function statistiques_vides($prec, $largeur, $rapport, $moyenne, $script)
 {
 	$hauteur_moyenne = round($moyenne*$rapport)-1;
@@ -412,6 +435,11 @@ 
 
 // Dimanche en couleur foncee
 // http://doc.spip.org/@statistiques_jour
+/**
+ * @param double $moyenne
+ * @param double $hauteur
+ * @param boolean $dimanche
+ */
 function statistiques_jour($key, $value, $largeur, $moyenne, $hauteur, $rapport, $dimanche, $script)
 {
 	$hauteur_moyenne = round($moyenne * $rapport) - 1;
@@ -448,6 +476,9 @@ 
 }
 
 // http://doc.spip.org/@statistiques_nom_des_mois
+/**
+ * @param double $agreg
+ */
 function statistiques_nom_des_mois($date_debut, $date_today, $largeur, $pas, $agreg)
 {
 	global $spip_lang_left;
@@ -474,6 +505,9 @@ 
 }
 
 // http://doc.spip.org/@statistiques_par_mois
+/**
+ * @param string $script
+ */
 function statistiques_par_mois($entrees, $script){
 
 	$maxgraph = maxgraph(max($entrees));

ecrire/inc/suivi_versions.php

Doc Comments +12 added lines

@@ -135,6 +135,9 @@ 
 }
 
 // http://doc.spip.org/@revisions_bouton
+/**
+ * @param string $lang_dir
+ */
 function revisions_bouton($id_article, $id_auteur, $id_version, $titre, $statut, $date, $lang_dir, $nom)
 {
 	$titre_bouton = "<span class='arial2'>";
@@ -149,6 +152,15 @@ 
 }
 
 // http://doc.spip.org/@revisions_entete_boite
+/**
+ * @param boolean $court
+ * @param integer $debut
+ * @param integer $id_secteur
+ * @param string $lang
+ * @param integer $nb_aff
+ * @param string $req_from
+ * @param boolean $uniq_auteur
+ */
 function revisions_entete_boite($court, $debut, $id_secteur, $lang, $nb_aff, $req_from, $req_where, $uniq_auteur)
 {
 

ecrire/inc/syndic.php

Doc Comments +6 added lines

@@ -281,6 +281,9 @@ 
 // helas strtotime ne reconnait pas le format W3C
 // http://www.w3.org/TR/NOTE-datetime
 // http://doc.spip.org/@my_strtotime
+/**
+ * @param string $la_date
+ */
 function my_strtotime($la_date) {
 
 	// format complet
@@ -317,6 +320,9 @@ 
 // A partir d'un <dc:subject> ou autre essayer de recuperer
 // le mot et son url ; on cree <a href="url" rel="tag">mot</a>
 // http://doc.spip.org/@creer_tag
+/**
+ * @param string $type
+ */
 function creer_tag($mot,$type,$url) {
 	if (!strlen($mot = trim($mot))) return '';
 	$mot = "<a rel=\"tag\">$mot</a>";

ecrire/inc/texte.php

Doc Comments +15 added lines

@@ -478,6 +478,9 @@ 
 // avec protection prealable des balises HTML et SPIP
 
 // http://doc.spip.org/@typo
+/**
+ * @param string $connect
+ */
 function typo($letexte, $echapper=true, $connect=null) {
 	// Plus vite !
 	if (!$letexte) return $letexte;
@@ -581,6 +584,9 @@ 
 define('_RACCOURCI_THEAD', true);
 
 // http://doc.spip.org/@traiter_tableau
+/**
+ * @param string $bloc
+ */
 function traiter_tableau($bloc) {
 
 	// Decouper le tableau en lignes
@@ -809,6 +815,9 @@ 
 // Sert aussi a nettoyer un texte qu'on veut mettre dans un <a> etc.
 // TODO: gerer les modeles ?
 // http://doc.spip.org/@supprime_img
+/**
+ * @param string $message
+ */
 function supprime_img($letexte, $message=NULL) {
 	if ($message===NULL) $message = '(' . _T('img_indisponible') . ')';
 	return preg_replace(',<(img|doc|emb)([0-9]+)(\|([^>]*))?'.'\s*/?'.'>,i',
@@ -823,6 +832,9 @@ 
 // deuxieme argument : forcer les <p> meme pour un seul paragraphe
 //
 // http://doc.spip.org/@paragrapher
+/**
+ * @param string $letexte
+ */
 function paragrapher($letexte, $forcer=true) {
 	global $class_spip;
 
@@ -884,6 +896,9 @@ 
 
 // Harmonise les retours chariots et mange les paragraphes html
 // http://doc.spip.org/@traiter_retours_chariots
+/**
+ * @return string
+ */
 function traiter_retours_chariots($letexte) {
 	$letexte = preg_replace(",\r\n?,S", "\n", $letexte);
 	$letexte = preg_replace(",<p[>[:space:]],iS", "\n\n\\0", $letexte);

ecrire/inc/tourner.php

Doc Comments +10 added lines

@@ -68,6 +68,9 @@ 
 }
 
 // http://doc.spip.org/@tourner_greffe
+/**
+ * @param string|null $res
+ */
 function tourner_greffe($id_document, $document, $url, $res)
 {
 	$res .= "<div style='text-align: center;'>"
@@ -81,6 +84,9 @@ 
 }
 
 // http://doc.spip.org/@boutons_rotateurs
+/**
+ * @param integer $id
+ */
 function boutons_rotateurs($document, $type, $id, $id_document, $script) {
 	global $spip_lang_right;
 
@@ -112,6 +118,10 @@ 
 }
 
 // http://doc.spip.org/@bouton_tourner_document
+/**
+ * @param integer $rot
+ * @param string $img
+ */
 function bouton_tourner_document($id, $id_document, $script, $rot, $type, $img, $title)
 {
   return ajax_action_auteur("tourner",