Changeset 43779 in spip-zone


Ignore:
Timestamp:
Jan 21, 2011, 11:10:49 PM (8 years ago)
Author:
cedric@…
Message:

PHPDoc

Location:
_core_/plugins/medias
Files:
19 edited

Legend:

Unmodified
Added
Removed
  • _core_/plugins/medias/action/ajouter_documents.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
     
    1919include_spip('inc/renseigner_document');
    2020
     21/**
     22 * Ajouter des documents
     23 *
     24 * @param int $id_document
     25 *   document a remplacer, ou pour une vignette, l'id_document de maman
     26 *   0 ou 'new' pour une insertion
     27 * @param  $files
     28 *   tableau de taleau de propriete pour chaque document a inserer
     29 * @param  $objet
     30 *   objet auquel associer le document
     31 * @param  $id_objet
     32 *   id_objet
     33 * @param  $mode
     34 *   mode par defaut si pas precise pour le document
     35 * @return array
     36 *   liste des id_documents inseres
     37 */
    2138function action_ajouter_documents_dist($id_document, $files, $objet, $id_objet, $mode){
    2239        $ajouter_un_document = charger_fonction('ajouter_un_document','action');
     
    3653/**
    3754 * Ajouter un document (au format $_FILES)
    38  * $id_document,        # document a remplacer, ou pour une vignette, l'id_document de maman
    39  * $source,     # le fichier sur le serveur (/var/tmp/xyz34)
    40  * $nom_envoye, # son nom chez le client (portequoi.pdf)
    41  * $objet,      # lie a un article, une breve ou une rubrique ?
    42  * $id_objet,   # identifiant de l'article (ou rubrique) lie
    43  * $mode,       # 'image' => image en mode image
    44  *          'vignette' => personnalisee liee a un document
    45  *          'document' => doc ou image en mode document
    46  *          'distant' => lien internet
    47  * $actifs      # les documents dont il faudra ouvrir la boite de dialogue
    4855 *
    49  * @param unknown_type $id_document
    50  * @param array $source
    51  * @param unknown_type $nom_envoye
    52  * @param unknown_type $objet
    53  * @param unknown_type $id_objet
    54  * @param unknown_type $mode
    55  * @param unknown_type $documents_actifs
    56  * @param unknown_type $titrer
    57  * @return unknown
    58  */
    59 // http://doc.spip.org/@ajouter_un_document
     56 * http://doc.spip.org/@ajouter_un_document
     57 *
     58 * @param int $id_document
     59 *   document a remplacer, ou pour une vignette, l'id_document de maman
     60 *   0 ou 'new' pour une insertion
     61 * @param array $file
     62 *   proprietes au format $_FILE etendu :
     63 *     strin tmp_name : source sur le serveur
     64 *     string name : nom du fichier envoye
     65 *     bool titrer : donner ou non un titre a partir du nom du fichier
     66 *     bool distant : pour utiliser une source distante sur internet
     67 *     string mode : vignette|image|documents|choix
     68 * @param string $objet
     69 *   objet auquel associer le document
     70 * @param int $id_objet
     71 *   id_objet
     72 * @param string $mode
     73 *   mode par defaut si pas precise pour le document
     74 * @return array|bool|int|mixed|string|unknown
     75 */
    6076function action_ajouter_un_document_dist($id_document, $file, $objet, $id_objet, $mode) {
    6177       
     
    195211
    196212
    197 if (!function_exists('corriger_extension')){
    198213/**
    199214 * Corrige l'extension du fichier dans quelques cas particuliers
     
    220235        return $ext;
    221236}
    222 }
    223237
    224238/**
     
    259273function fixer_fichier_upload($file){
    260274
    261 
    262 
    263275        if (is_array($row=verifier_upload_autorise($file['name']))) {
    264276                $row['fichier'] = copier_document($row['extension'], $file['name'], $file['tmp_name']);
     
    308320}
    309321
    310 
     322/**
     323 * Verifier si le fichier respecte les contraintes de tailles
     324 *
     325 * @param  $infos
     326 * @return bool|mixed|string
     327 */
    311328function verifier_taille_document_acceptable($infos){
    312329       
  • _core_/plugins/medias/action/changer_mode_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
     
    1414
    1515
    16 // Cette action permet de basculer du mode image au mode document et vice versa
     16/**
     17 * Cette action permet de basculer du mode image au mode document et vice versa
     18 *
     19 * http://doc.spip.org/@action_changer_mode_document_dist
     20 *
     21 * @return void
     22 */
     23function action_changer_mode_document_dist($id_document=null, $mode=null){
     24        if (is_null($id_document) OR is_null($mode)){
     25                $securiser_action = charger_fonction('securiser_action', 'inc');
     26                $arg = $securiser_action();
    1727
    18 // http://doc.spip.org/@action_changer_mode_document_dist
    19 function action_changer_mode_document_dist()
    20 {
    21         $securiser_action = charger_fonction('securiser_action', 'inc');
    22         $arg = $securiser_action();
     28                if (!preg_match(",^(\d+)\W(\w+)$,", $arg, $r))
     29                        spip_log("action_changer_mode_document $arg pas compris");
     30                else {
     31                        array_shift($r);
     32            list($id_document, $mode) = $r;
     33                }
     34        }
    2335
    24         if (!preg_match(",^(\d+)\W(\w+)$,", $arg, $r))
    25                 spip_log("action_changer_mode_document $arg pas compris");
    26         else action_changer_mode_document_post($r[1],$r[2]);
     36        if ($id_document)
     37                action_changer_mode_document_post($id_document, $mode);
    2738}
    2839
  • _core_/plugins/medias/action/copier_local.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
     
    1313if (!defined("_ECRIRE_INC_VERSION")) return;
    1414
    15 // Fonction appellee lorsque l'utilisateur clique sur le bouton
    16 // 'copier en local' (document/portfolio).
    17 // Il s'agit de la partie logique, c'est a dire que cette fonction
    18 // realise la copie.
    19 
    20 // http://doc.spip.org/@action_copier_local_dist
     15/**
     16 * Fonction appellee lorsque l'utilisateur clique sur le bouton
     17 * 'copier en local' (document/portfolio).
     18 * Il s'agit de la partie logique, c'est a dire que cette fonction
     19 * realise la copie.
     20 *
     21 * http://doc.spip.org/@action_copier_local_dist
     22 *
     23 * @param null $id_document
     24 * @return bool|mixed|string
     25 */
    2126function action_copier_local_dist($id_document=null) {
    2227
     
    3843}
    3944
    40 // http://doc.spip.org/@action_copier_local_post
     45/**
     46 * http://doc.spip.org/@action_copier_local_post
     47 *
     48 * @param  $id_document
     49 * @return bool|mixed|string
     50 */
    4151function action_copier_local_post($id_document) {
    4252
  • _core_/plugins/medias/action/editer_document.php

    r43743 r43779  
    11<?php
    2 /**
    3  * Plugin Portfolio/Gestion des documents
    4  * Licence GPL (c) 2006-2008 Cedric Morin, romy.tetue.net
    5  *
    6  */
     2
     3/***************************************************************************\
     4 *  SPIP, Systeme de publication pour l'internet                           *
     5 *                                                                         *
     6 *  Copyright (c) 2001-2011                                                *
     7 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
     8 *                                                                         *
     9 *  Ce programme est un logiciel libre distribue sous licence GNU/GPL.     *
     10 *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
     11\***************************************************************************/
    712
    813if (!defined("_ECRIRE_INC_VERSION")) return;
     14
    915
    1016/**
     
    2127        if (!$id_document = intval($arg)) {
    2228                $id_document = insert_document();
    23         } 
     29        }
    2430
    2531        if ($id_document = intval($id_document)) {
     
    130136
    131137}
     138
     139
    132140/**
    133141 * determiner le statut d'un document : prepa/publie
  • _core_/plugins/medias/action/supprimer_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/action/tourner.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
     
    1313if (!defined("_ECRIRE_INC_VERSION")) return;
    1414
    15 // http://doc.spip.org/@action_tourner_dist
    16 function action_tourner_dist() {
    17         $securiser_action = charger_fonction('securiser_action', 'inc');
    18         $arg = $securiser_action();
     15/**
     16 * Tourner un document
     17 *
     18 * http://doc.spip.org/@action_tourner_dist
     19 *
     20 * lorsque les arguments sont passes dans arg en GET :
     21 * id_document-angle
     22 *
     23 * @param int $id_document
     24 * @param int $angle
     25 *   angle de rotation en degre>0
     26 * @return void
     27 */
     28function action_tourner_dist($id_document=null, $angle=null) {
     29        if (is_null($id_document) OR is_null($angle)){
     30                $securiser_action = charger_fonction('securiser_action', 'inc');
     31                $arg = $securiser_action();
    1932
    20         if (!preg_match(",^\W*(\d+)\W?(-?\d+)$,", $arg, $r)) {
    21                 spip_log("action_tourner_dist $arg pas compris");
    22         } else  action_tourner_post($r[1],$r[2]);
     33                if (!preg_match(",^\W*(\d+)\W?(-?\d+)$,", $arg, $r)) {
     34                        spip_log("action_tourner_dist $arg pas compris");
     35                }
     36                else{
     37                        array_shift($r);
     38                        list($id_document,$angle) = $r;
     39                }
     40
     41        }
     42        if ($id_document AND autoriser('modifier','document',$id_document))
     43                action_tourner_post($id_document,$angle);
    2344}
    2445
    25 // http://doc.spip.org/@action_tourner_post
     46/**
     47 * Tourner un document
     48 *
     49 * http://doc.spip.org/@action_tourner_post
     50 *
     51 * @param int $id_document
     52 * @param int $angle
     53 *   angle de rotation en degre>0
     54 * @return
     55 */
    2656function action_tourner_post($id_document,$angle)
    2757{
  • _core_/plugins/medias/action/verifier_documents_brises.php

    r43743 r43779  
    11<?php
    2 /**
    3  * Plugin Portfolio/Gestion des documents
    4  * Licence GPL (c) 2006-2008 Cedric Morin, romy.tetue.net
    5  *
    6  */
     2
     3/***************************************************************************\
     4 *  SPIP, Systeme de publication pour l'internet                           *
     5 *                                                                         *
     6 *  Copyright (c) 2001-2011                                                *
     7 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
     8 *                                                                         *
     9 *  Ce programme est un logiciel libre distribue sous licence GNU/GPL.     *
     10 *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
     11\***************************************************************************/
    712
    813if (!defined("_ECRIRE_INC_VERSION")) return;
  • _core_/plugins/medias/base/typedoc.php

    r43738 r43779  
    1111\***************************************************************************/
    1212
    13 
    14 //
    1513if (!defined('_ECRIRE_INC_VERSION')) return;
    1614
  • _core_/plugins/medias/exec/documents_edit.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/exec/portfolio.php

    r43743 r43779  
    11<?php
    2 /**
    3  * Plugin Portfolio/Gestion des documents
    4  * Licence GPL (c) 2006-2008 Cedric Morin, romy.tetue.net
    5  *
    6  */
     2
     3/***************************************************************************\
     4 *  SPIP, Systeme de publication pour l'internet                           *
     5 *                                                                         *
     6 *  Copyright (c) 2001-2011                                                *
     7 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
     8 *                                                                         *
     9 *  Ce programme est un logiciel libre distribue sous licence GNU/GPL.     *
     10 *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
     11\***************************************************************************/
    712
    813if (!defined("_ECRIRE_INC_VERSION")) return;
     14
    915
    1016include_spip('inc/presentation');
  • _core_/plugins/medias/formulaires/changer_fichier_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/formulaires/editer_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/formulaires/illustrer_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/formulaires/joindre_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/inc/choisir_mode_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/inc/documenter_objet.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/inc/joindre_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
  • _core_/plugins/medias/inc/marquer_doublons_doc.php

    r43743 r43779  
    11<?php
    2 /*
    3  * Plugin xxx
    4  * (c) 2009 cedric
    5  * Distribue sous licence GPL
    6  *
    7  */
     2
     3/***************************************************************************\
     4 *  SPIP, Systeme de publication pour l'internet                           *
     5 *                                                                         *
     6 *  Copyright (c) 2001-2011                                                *
     7 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
     8 *                                                                         *
     9 *  Ce programme est un logiciel libre distribue sous licence GNU/GPL.     *
     10 *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
     11\***************************************************************************/
     12
     13if (!defined("_ECRIRE_INC_VERSION")) return;
     14
    815
    916// On liste tous les champs susceptibles de contenir des documents ou images si on veut que ces derniers soient lies a l objet lorsqu on y fait reference par imgXX docXX ou embXX
  • _core_/plugins/medias/inc/renseigner_document.php

    r43743 r43779  
    44 *  SPIP, Systeme de publication pour l'internet                           *
    55 *                                                                         *
    6  *  Copyright (c) 2001-2009                                                *
     6 *  Copyright (c) 2001-2011                                                *
    77 *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
    88 *                                                                         *
Note: See TracChangeset for help on using the changeset viewer.