The branch, master has been updated
via e0b32c7aaad348635044a2bda2e9d5712b198e6b (commit)
from 31010806f75222e2c6a70429d1f3003eaf323f40 (commit)
- Log -----------------------------------------------------------------
commit e0b32c7aaad348635044a2bda2e9d5712b198e6b
Author: Michal Čihař <mcihar(a)novell.com>
Date: Mon May 24 12:04:20 2010 +0200
Convert transformation descriptions to gettext.
-----------------------------------------------------------------------
Summary of changes:
Documentation.html | 12 ++++++++++++
libraries/messages.inc.php | 13 -------------
libraries/transformations/TEMPLATE | 6 ++++++
.../application_octetstream__download.inc.php | 6 ++++++
.../application_octetstream__hex.inc.php | 6 ++++++
.../transformations/image_jpeg__inline.inc.php | 6 ++++++
libraries/transformations/image_jpeg__link.inc.php | 6 ++++++
.../transformations/image_png__inline.inc.php | 6 ++++++
.../transformations/text_plain__dateformat.inc.php | 6 ++++++
.../transformations/text_plain__external.inc.php | 6 ++++++
.../transformations/text_plain__formatted.inc.php | 6 ++++++
.../transformations/text_plain__imagelink.inc.php | 6 ++++++
libraries/transformations/text_plain__link.inc.php | 6 ++++++
.../transformations/text_plain__longToIpv4.inc.php | 6 ++++++
libraries/transformations/text_plain__sql.inc.php | 6 ++++++
.../transformations/text_plain__substr.inc.php | 6 ++++++
transformation_overview.php | 12 ++++++++++--
17 files changed, 106 insertions(+), 15 deletions(-)
diff --git a/Documentation.html b/Documentation.html
index 13bdc90..bbf6d2a 100644
--- a/Documentation.html
+++ b/Documentation.html
@@ -2576,6 +2576,18 @@ setfacl -d -m "g:www-data:rwx" tmp
field (i.e. 'text/plain', 'image/jpeg' etc.)</li>
</ol>
+<p> Additionally you should also provide additional function to provide
+ information about the transformation to the user. This function should
+ have same name as transformation function just with appended
+ <code>_info</code> suffix. This function accepts no parameters and
returns
+ array with information about the transformation. Currently following keys
+ can be used:
+<p>
+<dl>
+ <dt><code>info</code></dt>
+ <dd>Long description of the transformation.</dd>
+</dl>
+
<!-- FAQ -->
<h2 id="faq">FAQ - Frequently Asked Questions</h2>
diff --git a/libraries/messages.inc.php b/libraries/messages.inc.php
index d071f75..cc5bac9 100644
--- a/libraries/messages.inc.php
+++ b/libraries/messages.inc.php
@@ -129,17 +129,4 @@ $strShowStatusThreads_cachedDescr = __('The number of threads in
the thread cach
$strShowStatusThreads_connectedDescr = __('The number of currently open
connections.');
$strShowStatusThreads_createdDescr = __('The number of threads created to handle
connections. If Threads_created is big, you may want to increase the thread_cache_size
value. (Normally this doesn\'t give a notable performance improvement if you have a
good thread implementation.)');
$strShowStatusThreads_runningDescr = __('The number of threads that are not
sleeping.');
-
-$strTransformation_application_octetstream__download = __('Displays a link to
download the binary data of the field. You can use the first option to specify the
filename, or use the second option as the name of a field which contains the filename. If
you use the second option, you need to set the first option to the empty string.');
-$strTransformation_application_octetstream__hex = __('Displays hexadecimal
representation of data. Optional first parameter specifies how often space will be added
(defaults to 2 nibbles).');
-$strTransformation_image_jpeg__inline = __('Displays a clickable thumbnail. The
options are the maximum width and height in pixels. The original aspect ratio is
preserved.');
-$strTransformation_image_jpeg__link = __('Displays a link to download this
image.');
-$strTransformation_image_png__inline = __('See image/jpeg: inline');
-$strTransformation_text_plain__dateformat = __('Displays a TIME, TIMESTAMP, DATETIME
or numeric unix timestamp field as formatted date. The first option is the offset (in
hours) which will be added to the timestamp (Default: 0). Use second option to specify a
different date/time format string. Third option determines whether you want to see local
date or UTC one (use "local" or "utc" strings) for that. According to
that, date format has different value - for "local" see the documentation for
PHP\'s strftime() function and for "utc" it is done using gmdate()
function.');
-$strTransformation_text_plain__external = __('LINUX ONLY: Launches an external
application and feeds it the field data via standard input. Returns the standard output of
the application. The default is Tidy, to pretty-print HTML code. For security reasons, you
have to manually edit the file libraries/transformations/text_plain__external.inc.php and
list the tools you want to make available. The first option is then the number of the
program you want to use and the second option is the parameters for the program. The third
option, if set to 1, will convert the output using htmlspecialchars() (Default 1). The
fourth option, if set to 1, will prevent wrapping and ensure that the output appears all
on one line (Default 1).');
-$strTransformation_text_plain__formatted = __('Displays the contents of the field
as-is, without running it through htmlspecialchars(). That is, the field is assumed to
contain valid HTML.');
-$strTransformation_text_plain__imagelink = __('Displays an image and a link; the
field contains the filename. The first option is a URL prefix like
"http://www.example.com/". The second and third options are the width and the
height in pixels.');
-$strTransformation_text_plain__link = __('Displays a link; the field contains the
filename. The first option is a URL prefix like "http://www.example.com/". The
second option is a title for the link.');
-$strTransformation_text_plain__sql = __('Formats text as SQL query with syntax
highlighting.');
-$strTransformation_text_plain__substr = __('Displays a part of a string. The first
option is the number of characters to skip from the beginning of the string (Default 0).
The second option is the number of characters to return (Default: until end of string).
The third option is the string to append and/or prepend when truncation occurs (Default:
"...").');
?>
diff --git a/libraries/transformations/TEMPLATE b/libraries/transformations/TEMPLATE
index f3000ad..eabb194 100644
--- a/libraries/transformations/TEMPLATE
+++ b/libraries/transformations/TEMPLATE
@@ -12,6 +12,12 @@
* extension. For further information regarding naming conventions see the
/Documentation.html file.
*/
+function PMA_transformation_[ENTER_FILENAME_HERE]_info() {
+ return array(
+ 'info' => __('Description of the transformation.'),
+ );
+}
+
function PMA_transformation_[ENTER_FILENAME_HERE]($buffer, $options = array(), $meta =
'') {
// possibly use a global transform and feed it with special options:
// include('./libraries/transformations/global.inc.php');
diff --git a/libraries/transformations/application_octetstream__download.inc.php
b/libraries/transformations/application_octetstream__download.inc.php
index 2025632..369126d 100644
--- a/libraries/transformations/application_octetstream__download.inc.php
+++ b/libraries/transformations/application_octetstream__download.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_application_octetstream__download_info() {
+ return array(
+ 'info' => __('Displays a link to download the binary data of the
field. You can use the first option to specify the filename, or use the second option as
the name of a field which contains the filename. If you use the second option, you need to
set the first option to the empty string.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/application_octetstream__hex.inc.php
b/libraries/transformations/application_octetstream__hex.inc.php
index a9b485f..7122354 100644
--- a/libraries/transformations/application_octetstream__hex.inc.php
+++ b/libraries/transformations/application_octetstream__hex.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_application_octetstream__hex_info() {
+ return array(
+ 'info' => __('Displays hexadecimal representation of data.
Optional first parameter specifies how often space will be added (defaults to 2
nibbles).'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/image_jpeg__inline.inc.php
b/libraries/transformations/image_jpeg__inline.inc.php
index d97dcb9..682e4a0 100644
--- a/libraries/transformations/image_jpeg__inline.inc.php
+++ b/libraries/transformations/image_jpeg__inline.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_image_jpeg__inline_info() {
+ return array(
+ 'info' => __('Displays a clickable thumbnail. The options are the
maximum width and height in pixels. The original aspect ratio is preserved.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/image_jpeg__link.inc.php
b/libraries/transformations/image_jpeg__link.inc.php
index 43fd9c8..5223e50 100644
--- a/libraries/transformations/image_jpeg__link.inc.php
+++ b/libraries/transformations/image_jpeg__link.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_image_jpeg__link_info() {
+ return array(
+ 'info' => __('Displays a link to download this image.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/image_png__inline.inc.php
b/libraries/transformations/image_png__inline.inc.php
index 1801878..f631aa4 100644
--- a/libraries/transformations/image_png__inline.inc.php
+++ b/libraries/transformations/image_png__inline.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_image_png__inline_info() {
+ return array(
+ 'info' => __('Displays a clickable thumbnail. The options are the
maximum width and height in pixels. The original aspect ratio is preserved.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/text_plain__dateformat.inc.php
b/libraries/transformations/text_plain__dateformat.inc.php
index c1386fa..3f11fa9 100644
--- a/libraries/transformations/text_plain__dateformat.inc.php
+++ b/libraries/transformations/text_plain__dateformat.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_text_plain__dateformat_info() {
+ return array(
+ 'info' => __('Displays a TIME, TIMESTAMP, DATETIME or numeric unix
timestamp field as formatted date. The first option is the offset (in hours) which will be
added to the timestamp (Default: 0). Use second option to specify a different date/time
format string. Third option determines whether you want to see local date or UTC one (use
"local" or "utc" strings) for that. According to that, date format has
different value - for "local" see the documentation for PHP\'s strftime()
function and for "utc" it is done using gmdate() function.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/text_plain__external.inc.php
b/libraries/transformations/text_plain__external.inc.php
index 69100de..981faec 100644
--- a/libraries/transformations/text_plain__external.inc.php
+++ b/libraries/transformations/text_plain__external.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_text_plain__external_info() {
+ return array(
+ 'info' => __('LINUX ONLY: Launches an external application and
feeds it the field data via standard input. Returns the standard output of the
application. The default is Tidy, to pretty-print HTML code. For security reasons, you
have to manually edit the file libraries/transformations/text_plain__external.inc.php and
list the tools you want to make available. The first option is then the number of the
program you want to use and the second option is the parameters for the program. The third
option, if set to 1, will convert the output using htmlspecialchars() (Default 1). The
fourth option, if set to 1, will prevent wrapping and ensure that the output appears all
on one line (Default 1).'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/text_plain__formatted.inc.php
b/libraries/transformations/text_plain__formatted.inc.php
index 65e1458..7a1e8f8 100644
--- a/libraries/transformations/text_plain__formatted.inc.php
+++ b/libraries/transformations/text_plain__formatted.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_text_plain__formatted_info() {
+ return array(
+ 'info' => __('Displays the contents of the field as-is, without
running it through htmlspecialchars(). That is, the field is assumed to contain valid
HTML.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/text_plain__imagelink.inc.php
b/libraries/transformations/text_plain__imagelink.inc.php
index 8540d76..d743a16 100644
--- a/libraries/transformations/text_plain__imagelink.inc.php
+++ b/libraries/transformations/text_plain__imagelink.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_text_plain__imagelink_info() {
+ return array(
+ 'info' => __('Displays an image and a link; the field contains the
filename. The first option is a URL prefix like "http://www.example.com/". The
second and third options are the width and the height in pixels.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/text_plain__link.inc.php
b/libraries/transformations/text_plain__link.inc.php
index 9295de4..f9e2bf1 100644
--- a/libraries/transformations/text_plain__link.inc.php
+++ b/libraries/transformations/text_plain__link.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_text_plain__link_info() {
+ return array(
+ 'info' => __('Displays a link; the field contains the filename.
The first option is a URL prefix like "http://www.example.com/". The second
option is a title for the link.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/text_plain__longToIpv4.inc.php
b/libraries/transformations/text_plain__longToIpv4.inc.php
index 7f9d6b8..bcfc12a 100644
--- a/libraries/transformations/text_plain__longToIpv4.inc.php
+++ b/libraries/transformations/text_plain__longToIpv4.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_text_plain__longToIpv4_info() {
+ return array(
+ 'info' => __('Converts an (IPv4) Internet network address into a
string in Internet standard dotted format.'),
+ );
+}
+
/**
* returns IPv4 address
*
diff --git a/libraries/transformations/text_plain__sql.inc.php
b/libraries/transformations/text_plain__sql.inc.php
index 7bc38d4..5d5bfb1 100644
--- a/libraries/transformations/text_plain__sql.inc.php
+++ b/libraries/transformations/text_plain__sql.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_text_plain__sql_info() {
+ return array(
+ 'info' => __('Formats text as SQL query with syntax
highlighting.'),
+ );
+}
+
/**
*
*/
diff --git a/libraries/transformations/text_plain__substr.inc.php
b/libraries/transformations/text_plain__substr.inc.php
index 6b9520e..9982dcb 100644
--- a/libraries/transformations/text_plain__substr.inc.php
+++ b/libraries/transformations/text_plain__substr.inc.php
@@ -5,6 +5,12 @@
* @version $Id$
*/
+function PMA_transformation_text_plain__substr_info() {
+ return array(
+ 'info' => __('Displays a part of a string. The first option is the
number of characters to skip from the beginning of the string (Default 0). The second
option is the number of characters to return (Default: until end of string). The third
option is the string to append and/or prepend when truncation occurs (Default:
"...").'),
+ );
+}
+
/**
*
*/
diff --git a/transformation_overview.php b/transformation_overview.php
index fa7a0b0..12ca395 100644
--- a/transformation_overview.php
+++ b/transformation_overview.php
@@ -53,11 +53,19 @@ foreach ($types['mimetype'] as $key => $mimetype) {
$odd_row = true;
foreach ($types['transformation'] as $key => $transform) {
$func = strtolower(str_ireplace('.inc.php', '',
$types['transformation_file'][$key]));
- $desc = 'strTransformation_' . $func;
+ require './libraries/transformations/' .
$types['transformation_file'][$key];
+ $funcname = 'PMA_transformation_' . $func . '_info';
+ $desc = '<i>' . sprintf(__('No description is available for this
transformation.<br />Please ask the author what %s does.'),
'PMA_transformation_' . $func . '()') . '</i>';
+ if (function_exists($funcname)) {
+ $desc_arr = $funcname();
+ if (isset($desc_arr['info'])) {
+ $desc = $desc_arr['info'];
+ }
+ }
?>
<tr class="<?php echo $odd_row ? 'odd' : 'even';
?>">
<td><?php echo $transform; ?></td>
- <td><?php echo (isset($$desc) ? $$desc : '<i>' .
sprintf(__('No description is available for this transformation.<br />Please ask
the author what %s does.'), 'PMA_transformation_' . $func . '()') .
'</i>'); ?></td>
+ <td><?php echo $desc; ?></td>
</tr>
<?php
$odd_row = !$odd_row;
hooks/post-receive
--
phpMyAdmin