Changeset 25115 for trunk/ws.php

Timestamp:

Oct 24, 2013, 12:01:35 PM (11 years ago)

Author:

mistic100

Message:

two new options for API methods : 'admin_only' and 'post_only'

File:

• trunk/ws.php (modified) (30 diffs)

trunk/ws.php

@@ -136 +136 @@
       'ws_getInfos',
       null,
-      '<b>Admin only.</b> Returns general informations.'
+      '<b>Admin only.</b> Returns general informations.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -146 +148 @@
                            'type'=>WS_TYPE_ID),
         ),
-      '<b>Admin only.</b> Adds elements to the caddie. Returns the number of elements added.'
+      '<b>Admin only.</b> Adds elements to the caddie. Returns the number of elements added.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -205 +209 @@
                                 'type'=>WS_TYPE_INT|WS_TYPE_POSITIVE),
         ), $f_params),
-      '<b>Admin only.</b> Returns a list of derivatives to build.'
+      '<b>Admin only.</b> Returns a list of derivatives to build.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -217 +223 @@
         'key' =>      array(),
         ),
-      '<b>POST only.</b> Adds a comment to an image.'
+      '<b>POST only.</b> Adds a comment to an image.',
+      null,
+      array('post_only'=>true)
     );
 
@@ -269 +277 @@
                             'type'=>WS_TYPE_INT|WS_TYPE_POSITIVE),
         ),
-      '<b>Admin & POST only.</b> Sets the privacy levels for the images.'
+      '<b>Admin & POST only.</b> Sets the privacy levels for the images.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -280 +290 @@
         'rank'        => array('type'=>WS_TYPE_INT|WS_TYPE_POSITIVE|WS_TYPE_NOTNULL)
         ),
-      '<b>Admin & POST only.</b> Sets the rank of a photo for a given album.'
+      '<b>Admin & POST only.</b> Sets the rank of a photo for a given album.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -290 +302 @@
         'anonymous_id' => array('default'=>null),
         ),
-      '<b>Admin & POST only.</b> Deletes all rates for a user.'
+      '<b>Admin & POST only.</b> Deletes all rates for a user.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -304 +318 @@
       'ws_session_login',
       array('username', 'password'),
-      '<b>POST only.</b> Tries to login the user.'
+      '<b>POST only.</b> Tries to login the user.',
+      null,
+      array('post_only'=>true)
     );
 
@@ -358 +374 @@
         'position' =>     array()
         ),
-      '<b>Admin & POST only.</b> Add a chunk of a file.'
+      '<b>Admin & POST only.</b> Add a chunk of a file.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -371 +389 @@
         ),
       '<b>Admin only.</b> Add or update a file for an existing photo.
-<br>pwg.images.addChunk must have been called before (maybe several times).'
+<br>pwg.images.addChunk must have been called before (maybe several times).',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -402 +422 @@
       '<b>Admin only.</b> Add an image.
 <br>pwg.images.addChunk must have been called before (maybe several times).
-<br>Don\'t use "thumbnail_sum" and "high_sum", these parameters are here for backward compatibility.'
+<br>Don\'t use "thumbnail_sum" and "high_sum", these parameters are here for backward compatibility.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -426 +448 @@
 <br>Use the <b>$_FILES[image]</b> field for uploading file.
 <br>Set the form encoding to "form-data".
-<br>You can update an existing photo if you define an existing image_id.'
+<br>You can update an existing photo if you define an existing image_id.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -436 +460 @@
         'pwg_token' =>  array(),
         ),
-      '<b>Admin & POST only.</b> Deletes image(s).'
+      '<b>Admin & POST only.</b> Deletes image(s).',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -443 +469 @@
       'ws_categories_getAdminList',
       null,
-      '<b>Admin only.</b>'
+      '<b>Admin only.</b>',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -474 +502 @@
       '<b>Admin & POST only.</b> Deletes album(s).
 <br><b>photo_deletion_mode</b> can be "no_delete" (may create orphan photos), "delete_orphans"
-(default mode, only deletes photos linked to no other album) or "force_delete" (delete all photos, even those linked to other albums)'
+(default mode, only deletes photos linked to no other album) or "force_delete" (delete all photos, even those linked to other albums)',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -486 +516 @@
         ),
       '<b>Admin & POST only.</b> Move album(s).
-<br>Set parent as 0 to move to gallery root. Only virtual categories can be moved.'
+<br>Set parent as 0 to move to gallery root. Only virtual categories can be moved.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -496 +528 @@
         'image_id' =>     array('type'=>WS_TYPE_ID),
         ),
-      '<b>Admin & POST only.</b> Sets the representative photo for an album. The photo doesn\'t have to belong to the album.'
+      '<b>Admin & POST only.</b> Sets the representative photo for an album. The photo doesn\'t have to belong to the album.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -503 +537 @@
       'ws_tags_getAdminList',
       null,
-      '<b>Admin only.</b> '
+      '<b>Admin only.</b>',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -510 +546 @@
       'ws_tags_add',
       array('name'),
-      '<b>Admin only.</b> Adds a new tag.'
+      '<b>Admin only.</b> Adds a new tag.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -521 +559 @@
         ),
       '<b>Admin only.</b>  Checks existence of images.
-<br>Give <b>md5sum_list</b> if $conf[uniqueness_mode]==md5sum. Give <b>filename_list</b> if $conf[uniqueness_mode]==filename.'
+<br>Give <b>md5sum_list</b> if $conf[uniqueness_mode]==md5sum. Give <b>filename_list</b> if $conf[uniqueness_mode]==filename.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -534 +574 @@
         ),
       '<b>Admin only.</b> Checks if you have updated version of your files for a given photo, the answer can be "missing", "equals" or "differs".
-<br>Don\'t use "thumbnail_sum" and "high_sum", these parameters are here for backward compatibility.'
+<br>Don\'t use "thumbnail_sum" and "high_sum", these parameters are here for backward compatibility.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -541 +583 @@
       'ws_images_checkUpload',
       null,
-      '<b>Admin only.</b> Checks if Piwigo is ready for upload.'
+      '<b>Admin only.</b> Checks if Piwigo is ready for upload.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -567 +611 @@
 <br><b>single_value_mode</b> can be "fill_if_empty" (only use the input value if the corresponding values is currently empty) or "replace"
 (overwrite any existing value) and applies to single values properties like name/author/date_creation/comment.
-<br><b>multiple_value_mode</b> can be "append" (no change on existing values, add the new values) or "replace" and applies to multiple values properties like tag_ids/categories.'
+<br><b>multiple_value_mode</b> can be "append" (no change on existing values, add the new values) or "replace" and applies to multiple values properties like tag_ids/categories.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
 
@@ -578 +624 @@
         'comment' =>      array('default'=>null),
         ),
-      '<b>Admin & POST only.</b> Changes properties of an album.'
+      '<b>Admin & POST only.</b> Changes properties of an album.',
+      null,
+      array('admin_only'=>true, 'post_only'=>true)
     );
   
@@ -585 +633 @@
       'ws_plugins_getList',
       null,
-      '<b>Admin only.</b> Gets the list of plugins with id, name, version, state and description.'
+      '<b>Admin only.</b> Gets the list of plugins with id, name, version, state and description.',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -596 +646 @@
         'pwg_token' => array(),
         ),
-      '<b>Admin only.</b>'
+      '<b>Admin only.</b>',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -607 +659 @@
         'pwg_token' => array(),
         ),
-      '<b>Admin only.</b>'
+      '<b>Admin only.</b>',
+      null,
+      array('admin_only'=>true)
     );
 
@@ -619 +673 @@
         'pwg_token' => array(),
         ),
-      '<b>Webmaster only.</b>'
+      '<b>Webmaster only.</b>',
+      null,
+      array('admin_only'=>true)
   );
 
@@ -634 +690 @@
         'pwg_token' =>  array(),
       ),
-      '<b>Webmaster only.</b> Ignores an extension if it needs update.'
+      '<b>Webmaster only.</b> Ignores an extension if it needs update.',
+      null,
+      array('admin_only'=>true)
   );
 
@@ -641 +699 @@
       'ws_extensions_checkupdates',
       null,
-      '<b>Admin only.</b> Checks if piwigo or extensions are up to date.'
+      '<b>Admin only.</b> Checks if piwigo or extensions are up to date.',
+      null,
+      array('admin_only'=>true)
   );
 }