aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authormistic100 <mistic@piwigo.org>2014-01-24 12:50:48 +0000
committermistic100 <mistic@piwigo.org>2014-01-24 12:50:48 +0000
commit1f448f9b1e731688133a943fe451c3d73a3ae0c4 (patch)
tree47f93c6796f356bf15adc7307503fe42721e8d17
parent01324a50ad93d616a2b2ff3d0477ffbaa1a1ab95 (diff)
feature 2999; docblocks for history, install and metadata
git-svn-id: http://piwigo.org/svn/trunk@26946 68402e56-0260-453c-a942-63ccdbb3a9ee
-rw-r--r--admin/include/functions_history.inc.php20
-rw-r--r--admin/include/functions_install.inc.php24
-rw-r--r--admin/include/functions_metadata.php48
3 files changed, 77 insertions, 15 deletions
diff --git a/admin/include/functions_history.inc.php b/admin/include/functions_history.inc.php
index 61d676503..938061e96 100644
--- a/admin/include/functions_history.inc.php
+++ b/admin/include/functions_history.inc.php
@@ -21,8 +21,17 @@
// | USA. |
// +-----------------------------------------------------------------------+
+/**
+ * @package functions\admin\history
+ */
+
+
include_once(PHPWG_ROOT_PATH.'admin/include/tabsheet.class.php');
+/**
+ * Init tabsheet for history pages
+ * @ignore
+ */
function history_tabsheet()
{
global $page, $link_start;
@@ -34,11 +43,22 @@ function history_tabsheet()
$tabsheet->assign();
}
+/**
+ * Callback used to sort history entries
+ */
function history_compare($a, $b)
{
return strcmp($a['date'].$a['time'], $b['date'].$b['time']);
}
+/**
+ * Perform history search.
+ *
+ * @param array $data - used in trigger_change
+ * @param array $search
+ * @param string[] $types
+ * @param array
+ */
function get_history($data, $search, $types)
{
if (isset($search['fields']['filename']))
diff --git a/admin/include/functions_install.inc.php b/admin/include/functions_install.inc.php
index 9e479f54b..43043a0b0 100644
--- a/admin/include/functions_install.inc.php
+++ b/admin/include/functions_install.inc.php
@@ -22,16 +22,19 @@
// +-----------------------------------------------------------------------+
/**
- * loads an sql file and executes all queries
- *
+ * @package functions\admin\install
+ */
+
+
+/**
+ * Loads a SQL file and executes all queries.
* Before executing a query, $replaced is... replaced by $replacing. This is
* useful when the SQL file contains generic words. Drop table queries are
* not executed.
*
- * @param string filepath
- * @param string replaced
- * @param string replacing
- * @return void
+ * @param string $filepath
+ * @param string $replaced
+ * @param string $replacing
*/
function execute_sqlfile($filepath, $replaced, $replacing, $dblayer)
{
@@ -70,8 +73,6 @@ function execute_sqlfile($filepath, $replaced, $replacing, $dblayer)
/**
* Automatically activate all core themes in the "themes" directory.
- *
- * @return void
*/
function activate_core_themes()
{
@@ -86,6 +87,12 @@ function activate_core_themes()
}
}
+/**
+ * Connect to database during installation. Uses $_POST.
+ *
+ * @param array &$infos - populated with infos
+ * @param array &$errors - populated with errors
+ */
function install_db_connect(&$infos, &$errors)
{
try
@@ -99,4 +106,5 @@ function install_db_connect(&$infos, &$errors)
$errors[] = l10n($e->getMessage());
}
}
+
?> \ No newline at end of file
diff --git a/admin/include/functions_metadata.php b/admin/include/functions_metadata.php
index 5bcbb12bf..d969d06b1 100644
--- a/admin/include/functions_metadata.php
+++ b/admin/include/functions_metadata.php
@@ -21,9 +21,21 @@
// | USA. |
// +-----------------------------------------------------------------------+
+/**
+ * @package functions\admin\metadata
+ */
+
+
include_once(PHPWG_ROOT_PATH.'/include/functions_metadata.inc.php');
+/**
+ * Returns IPTC metadata to sync from a file, depending on IPTC mapping.
+ * @toto : clean code (factorize foreach)
+ *
+ * @param string $file
+ * @return array
+ */
function get_sync_iptc_data($file)
{
global $conf;
@@ -80,6 +92,12 @@ function get_sync_iptc_data($file)
return $iptc;
}
+/**
+ * Returns EXIF metadata to sync from a file, depending on EXIF mapping.
+ *
+ * @param string $file
+ * @return array
+ */
function get_sync_exif_data($file)
{
global $conf;
@@ -110,7 +128,11 @@ function get_sync_exif_data($file)
return $exif;
}
-
+/**
+ * Get all potential file metadata fields, including IPTC and EXIF.
+ *
+ * @return string[]
+ */
function get_sync_metadata_attributes()
{
global $conf;
@@ -139,6 +161,12 @@ function get_sync_metadata_attributes()
return array_unique($update_fields);
}
+/**
+ * Get all metadata of a file.
+ *
+ * @param array $infos - (path[, representative_ext])
+ * @return array - includes data provided in $infos
+ */
function get_sync_metadata($infos)
{
global $conf;
@@ -178,7 +206,12 @@ function get_sync_metadata($infos)
return $infos;
}
-
+/**
+ * Sync all metadata of a list of images.
+ * Metadata are fetched from original files and saved in database.
+ *
+ * @param int[] $ids
+ */
function sync_metadata($ids)
{
global $conf;
@@ -255,13 +288,13 @@ SELECT id, path, representative_ext
}
/**
- * returns an array associating element id (images.id) with its complete
+ * Returns an array associating element id (images.id) with its complete
* path in the filesystem
*
- * @param int id_uppercat
- * @param int site_id
- * @param boolean recursive ?
- * @param boolean only newly added files ?
+ * @param int $category_id
+ * @param int $site_id
+ * @param boolean $recursive
+ * @param boolean $only_new
* @return array
*/
function get_filelist($category_id = '', $site_id=1, $recursive = false,
@@ -317,4 +350,5 @@ SELECT id, path, representative_ext
;';
return hash_from_query($query, 'id');
}
+
?> \ No newline at end of file