Version Description
- New: [mla_gallery] shortcode, a superset of the [gallery] shortcode that provides many enhancements. These include taxonomy support and all post_mime_type values (not just images). Media Library items need not be "attached" to the post.
- New: [mla_gallery] shortcode documentation added to Settings page
- New: Donate button and link added to Settings page
Download this release
Release Info
Developer | dglingren |
Plugin | Media Library Assistant |
Version | 0.50 |
Comparing to | |
See all releases |
Code changes from version 0.41 to 0.50
- css/mla-style.css +9 -0
- includes/class-mla-data.php +30 -10
- includes/class-mla-main.php +1 -1
- includes/class-mla-objects.php +3 -1
- includes/class-mla-settings.php +21 -6
- includes/class-mla-shortcodes.php +407 -1
- index.php +2 -2
- phpDocs/classes/MLA.html +1 -1
- phpDocs/classes/MLAData.html +9 -5
- phpDocs/classes/MLAObjects.html +1 -1
- phpDocs/classes/MLASettings.html +15 -1
- phpDocs/classes/MLAShortcodes.html +44 -1
- phpDocs/classes/MLATest.html +1 -1
- phpDocs/classes/MLA_List_Table.html +1 -1
- phpDocs/deprecated.html +1 -1
- phpDocs/errors.html +1 -1
- phpDocs/graph_class.html +1 -1
- phpDocs/index.html +1 -1
- phpDocs/markers.html +1 -1
- phpDocs/namespaces/global.html +1 -1
- phpDocs/packages/Media Library Assistant.html +1 -1
- phpDocs/structure.xml +378 -315
- readme.txt +123 -7
- tpls/admin-display-settings-page.tpl +127 -2
- tpls/help-for-media_page_mla-menu.tpl +1 -1
css/mla-style.css
CHANGED
@@ -116,3 +116,12 @@ textarea[readonly] {
|
|
116 |
.bulk-edit-row-attachment fieldset.inline-edit-col-right label.inline-edit-tags span.title {
|
117 |
width: 99%
|
118 |
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
116 |
.bulk-edit-row-attachment fieldset.inline-edit-col-right label.inline-edit-tags span.title {
|
117 |
width: 99%
|
118 |
}
|
119 |
+
|
120 |
+
/*
|
121 |
+
* MLA Settings page
|
122 |
+
*/
|
123 |
+
|
124 |
+
ul.mla_settings {
|
125 |
+
list-style-type: disc;
|
126 |
+
list-style-position: inside
|
127 |
+
}
|
includes/class-mla-data.php
CHANGED
@@ -34,22 +34,42 @@ class MLAData {
|
|
34 |
*
|
35 |
* @since 0.1
|
36 |
*
|
37 |
-
* @param string Complete path and name of the template file
|
|
|
38 |
*
|
39 |
* @return string|array|false|NULL
|
40 |
* string for files that do not contain template divider comments,
|
41 |
* array for files containing template divider comments,
|
42 |
-
* false if file does not exist,
|
43 |
* NULL if file could not be loaded.
|
44 |
*/
|
45 |
-
public static function mla_load_template( $
|
46 |
-
|
47 |
-
|
48 |
-
|
49 |
-
|
50 |
-
|
51 |
-
|
52 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
53 |
}
|
54 |
|
55 |
$match_count = preg_match_all( '#\<!-- template=".+" --\>#', $template, $matches, PREG_OFFSET_CAPTURE );
|
34 |
*
|
35 |
* @since 0.1
|
36 |
*
|
37 |
+
* @param string Complete path and name of the template file, option name or the raw template
|
38 |
+
* @param string Type of template source; 'file', 'option', 'string'
|
39 |
*
|
40 |
* @return string|array|false|NULL
|
41 |
* string for files that do not contain template divider comments,
|
42 |
* array for files containing template divider comments,
|
43 |
+
* false if file or option does not exist,
|
44 |
* NULL if file could not be loaded.
|
45 |
*/
|
46 |
+
public static function mla_load_template( $source, $type = 'file' ) {
|
47 |
+
switch ( $type ) {
|
48 |
+
case 'file':
|
49 |
+
if ( !file_exists( $source ) )
|
50 |
+
return false;
|
51 |
+
|
52 |
+
$template = file_get_contents( $source, true );
|
53 |
+
if ( $template == false ) {
|
54 |
+
error_log( 'ERROR: mla_load_template file not found ' . var_export( $source, true ), 0 );
|
55 |
+
return NULL;
|
56 |
+
}
|
57 |
+
break;
|
58 |
+
case 'option':
|
59 |
+
$template = MLASettings::mla_get_option( $source );
|
60 |
+
if ( $template == false ) {
|
61 |
+
return false;
|
62 |
+
}
|
63 |
+
break;
|
64 |
+
case 'string':
|
65 |
+
$template = $source;
|
66 |
+
if ( empty( $template ) ) {
|
67 |
+
return false;
|
68 |
+
}
|
69 |
+
break;
|
70 |
+
default:
|
71 |
+
error_log( 'ERROR: mla_load_template bad source type ' . var_export( $type, true ), 0 );
|
72 |
+
return NULL;
|
73 |
}
|
74 |
|
75 |
$match_count = preg_match_all( '#\<!-- template=".+" --\>#', $template, $matches, PREG_OFFSET_CAPTURE );
|
includes/class-mla-main.php
CHANGED
@@ -38,7 +38,7 @@ class MLA {
|
|
38 |
*
|
39 |
* @var string
|
40 |
*/
|
41 |
-
const CURRENT_MLA_VERSION = '0.
|
42 |
|
43 |
/**
|
44 |
* Minimum version of PHP required for this plugin
|
38 |
*
|
39 |
* @var string
|
40 |
*/
|
41 |
+
const CURRENT_MLA_VERSION = '0.50';
|
42 |
|
43 |
/**
|
44 |
* Minimum version of PHP required for this plugin
|
includes/class-mla-objects.php
CHANGED
@@ -96,7 +96,9 @@ class MLAObjects {
|
|
96 |
add_filter( "manage_edit-{$tax_name}_columns", 'MLAObjects::mla_taxonomy_get_columns_filter', 10, 1 ); // $columns
|
97 |
add_filter( "manage_{$tax_name}_custom_column", 'MLAObjects::mla_taxonomy_column_filter', 10, 3 ); // $place_holder, $column_name, $tag->term_id
|
98 |
}
|
99 |
-
}
|
|
|
|
|
100 |
} // _build_taxonomies
|
101 |
|
102 |
/**
|
96 |
add_filter( "manage_edit-{$tax_name}_columns", 'MLAObjects::mla_taxonomy_get_columns_filter', 10, 1 ); // $columns
|
97 |
add_filter( "manage_{$tax_name}_custom_column", 'MLAObjects::mla_taxonomy_column_filter', 10, 3 ); // $place_holder, $column_name, $tag->term_id
|
98 |
}
|
99 |
+
} // foreach
|
100 |
+
|
101 |
+
// add_post_type_support( 'attachment', 'custom-fields' ); WP 3.5 experiment - MOVE THIS!
|
102 |
} // _build_taxonomies
|
103 |
|
104 |
/**
|
includes/class-mla-settings.php
CHANGED
@@ -174,6 +174,7 @@ class MLASettings {
|
|
174 |
self::$mla_alt_text_view = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
|
175 |
add_action( 'admin_menu', 'MLASettings::mla_admin_menu_action' );
|
176 |
self::_version_upgrade();
|
|
|
177 |
}
|
178 |
|
179 |
/**
|
@@ -213,19 +214,19 @@ class MLASettings {
|
|
213 |
} // version is less than .30
|
214 |
|
215 |
self::mla_update_option( self::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
|
216 |
-
self::mla_activation_hook();
|
217 |
}
|
218 |
|
219 |
/**
|
220 |
-
*
|
221 |
*
|
222 |
-
*
|
|
|
223 |
*
|
224 |
-
* @since 0.
|
225 |
*
|
226 |
* @return void
|
227 |
*/
|
228 |
-
|
229 |
global $wpdb, $table_prefix;
|
230 |
|
231 |
$view_name = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
|
@@ -252,6 +253,19 @@ class MLASettings {
|
|
252 |
}
|
253 |
}
|
254 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
255 |
/**
|
256 |
* Perform one-time actions on plugin deactivation
|
257 |
*
|
@@ -435,7 +449,8 @@ class MLASettings {
|
|
435 |
*/
|
436 |
$shortcodes = array(
|
437 |
// array("name" => "shortcode", "description" => "This shortcode...")
|
438 |
-
array( 'name' => 'mla_attachment_list', 'description' => 'renders a complete list of all attachments and references to them.' )
|
|
|
439 |
);
|
440 |
|
441 |
$shortcode_list = '';
|
174 |
self::$mla_alt_text_view = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
|
175 |
add_action( 'admin_menu', 'MLASettings::mla_admin_menu_action' );
|
176 |
self::_version_upgrade();
|
177 |
+
self::_create_alt_text_view();
|
178 |
}
|
179 |
|
180 |
/**
|
214 |
} // version is less than .30
|
215 |
|
216 |
self::mla_update_option( self::MLA_VERSION_OPTION, MLA::CURRENT_MLA_VERSION );
|
|
|
217 |
}
|
218 |
|
219 |
/**
|
220 |
+
* Add a view to the database to support sorting the listing on 'ALT Text'
|
221 |
*
|
222 |
+
* This function is called on each plugin invocation because the plugin upgrade process
|
223 |
+
* does not call the activation hook.
|
224 |
*
|
225 |
+
* @since 0.50
|
226 |
*
|
227 |
* @return void
|
228 |
*/
|
229 |
+
private static function _create_alt_text_view( ) {
|
230 |
global $wpdb, $table_prefix;
|
231 |
|
232 |
$view_name = $table_prefix . MLA_OPTION_PREFIX . self::MLA_ALT_TEXT_VIEW_SUFFIX;
|
253 |
}
|
254 |
}
|
255 |
|
256 |
+
/**
|
257 |
+
* Perform one-time actions on plugin activation
|
258 |
+
*
|
259 |
+
* Adds a view to the database to support sorting the listing on 'ALT Text'.
|
260 |
+
*
|
261 |
+
* @since 0.40
|
262 |
+
*
|
263 |
+
* @return void
|
264 |
+
*/
|
265 |
+
public static function mla_activation_hook( ) {
|
266 |
+
self::_create_alt_text_view();
|
267 |
+
}
|
268 |
+
|
269 |
/**
|
270 |
* Perform one-time actions on plugin deactivation
|
271 |
*
|
449 |
*/
|
450 |
$shortcodes = array(
|
451 |
// array("name" => "shortcode", "description" => "This shortcode...")
|
452 |
+
array( 'name' => 'mla_attachment_list', 'description' => 'renders a complete list of all attachments and references to them.' ),
|
453 |
+
array( 'name' => 'mla_gallery', 'description' => 'enhanced version of the WordPress [gallery] shortcode. For complete documentation <a href="#mla_gallery">click here</a>.' )
|
454 |
);
|
455 |
|
456 |
$shortcode_list = '';
|
includes/class-mla-shortcodes.php
CHANGED
@@ -22,6 +22,7 @@ class MLAShortcodes {
|
|
22 |
*/
|
23 |
public static function initialize() {
|
24 |
add_shortcode( 'mla_attachment_list', 'MLAShortcodes::mla_attachment_list_shortcode' );
|
|
|
25 |
}
|
26 |
|
27 |
/**
|
@@ -120,5 +121,410 @@ class MLAShortcodes {
|
|
120 |
|
121 |
echo "<br>----- End of Report -----\r\n";
|
122 |
}
|
123 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
124 |
?>
|
22 |
*/
|
23 |
public static function initialize() {
|
24 |
add_shortcode( 'mla_attachment_list', 'MLAShortcodes::mla_attachment_list_shortcode' );
|
25 |
+
add_shortcode( 'mla_gallery', 'MLAShortcodes::mla_gallery_shortcode' );
|
26 |
}
|
27 |
|
28 |
/**
|
121 |
|
122 |
echo "<br>----- End of Report -----\r\n";
|
123 |
}
|
124 |
+
|
125 |
+
/**
|
126 |
+
* The MLA Gallery shortcode.
|
127 |
+
*
|
128 |
+
* This is a superset of the WordPress Gallery shortcode for displaying images on a post,
|
129 |
+
* page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode.
|
130 |
+
* Enhancements include many additional selection parameters and full taxonomy support.
|
131 |
+
*
|
132 |
+
* @since .50
|
133 |
+
*
|
134 |
+
* @param array $attr Attributes of the shortcode.
|
135 |
+
*
|
136 |
+
* @return string HTML content to display gallery.
|
137 |
+
*/
|
138 |
+
public static function mla_gallery_shortcode($attr) {
|
139 |
+
global $post;
|
140 |
+
|
141 |
+
static $instance = 0;
|
142 |
+
$instance++;
|
143 |
+
|
144 |
+
$default_arguments = array(
|
145 |
+
'order' => 'ASC', // or 'DESC' or 'RAND'
|
146 |
+
'orderby' => 'menu_order ID',
|
147 |
+
'id' => NULL,
|
148 |
+
'itemtag' => 'dl',
|
149 |
+
'icontag' => 'dt',
|
150 |
+
'captiontag' => 'dd',
|
151 |
+
'link' => 'permalink', // or 'file'
|
152 |
+
'columns' => 3,
|
153 |
+
'size' => 'thumbnail',
|
154 |
+
'ids' => array ( ),
|
155 |
+
'include' => array ( ),
|
156 |
+
'exclude' => array ( ),
|
157 |
+
// MLA extensions, from WP_Query
|
158 |
+
// Force 'get_children' style query
|
159 |
+
'post_parent' => NULL, // post/page ID or 'current' or 'all'
|
160 |
+
// Author
|
161 |
+
'author' => NULL,
|
162 |
+
'author_name' => '',
|
163 |
+
// Category
|
164 |
+
'cat' => 0,
|
165 |
+
'category_name' => '',
|
166 |
+
'category__and' => array ( ),
|
167 |
+
'category__in' => array ( ),
|
168 |
+
'category__not_in' => array ( ),
|
169 |
+
// Tag
|
170 |
+
'tag' => '',
|
171 |
+
'tag_id' => 0,
|
172 |
+
'tag__and' => array ( ),
|
173 |
+
'tag__in' => array ( ),
|
174 |
+
'tag__not_in' => array ( ),
|
175 |
+
'tag_slug__and' => array ( ),
|
176 |
+
'tag_slug__in' => array ( ),
|
177 |
+
// Taxonomy parameters are handled separately
|
178 |
+
// {tax_slug} => 'term' | array ( 'term, 'term, ... )
|
179 |
+
// 'tax_query' => ''
|
180 |
+
// Post
|
181 |
+
'post_type' => 'attachment',
|
182 |
+
'post_status' => 'inherit',
|
183 |
+
'post_mime_type' => 'image',
|
184 |
+
// Pagination - no default for most of these
|
185 |
+
'nopaging' => true,
|
186 |
+
'posts_per_page' => 0,
|
187 |
+
'posts_per_archive_page' => 0,
|
188 |
+
'paged' => NULL, // page number or 'current'
|
189 |
+
'offset' => NULL,
|
190 |
+
// TBD Time
|
191 |
+
// Custom Field
|
192 |
+
'meta_key' => '',
|
193 |
+
'meta_value' => '',
|
194 |
+
'meta_value_num' => NULL,
|
195 |
+
'meta_compare' => '',
|
196 |
+
'meta_query' => '',
|
197 |
+
// Search
|
198 |
+
's' => ''
|
199 |
+
);
|
200 |
+
|
201 |
+
/*
|
202 |
+
* Merge input arguments with defaults, then extract the query arguments.
|
203 |
+
* $query_arguments has been initialized in the taxonomy code above.
|
204 |
+
*/
|
205 |
+
|
206 |
+
$arguments = shortcode_atts( $default_arguments, $attr );
|
207 |
+
|
208 |
+
if ( 'RAND' == $arguments['order'] )
|
209 |
+
$arguments['orderby'] = 'none';
|
210 |
+
|
211 |
+
if ( !empty( $arguments['ids'] ) ) {
|
212 |
+
// 'ids' is explicitly ordered
|
213 |
+
$arguments['orderby'] = 'post__in';
|
214 |
+
$arguments['include'] = $arguments['ids'];
|
215 |
+
}
|
216 |
+
unset( $arguments['ids'] );
|
217 |
+
|
218 |
+
/*
|
219 |
+
* Extract taxonomy arguments
|
220 |
+
*/
|
221 |
+
$taxonomies = get_taxonomies( array ( 'show_ui' => 'true' ), 'names' ); // 'objects'
|
222 |
+
$query_arguments = array ( );
|
223 |
+
if ( ! empty( $attr ) ) {
|
224 |
+
foreach ( $attr as $key => $value ) {
|
225 |
+
if ( 'tax_query' == $key ) {
|
226 |
+
if ( is_array( $value ) )
|
227 |
+
$query_arguments[ $key ] = $value;
|
228 |
+
else {
|
229 |
+
$function = @create_function('', 'return ' . $value . ';' );
|
230 |
+
|
231 |
+
if ( is_callable( $function ) )
|
232 |
+
$query_arguments[ $key ] = $function();
|
233 |
+
else
|
234 |
+
return '<p>ERROR: invalid mla_gallery tax_query = ' . var_export( $value, true ) . '</p>';
|
235 |
+
} // not array
|
236 |
+
} // tax_query
|
237 |
+
elseif ( array_key_exists( $key, $taxonomies ) ) {
|
238 |
+
$query_arguments[ $key ] = implode(',', array_filter( array_map( 'trim', explode( ",", $value ) ) ) );
|
239 |
+
} // array_key_exists
|
240 |
+
} //foreach $attr
|
241 |
+
} // ! empty
|
242 |
+
|
243 |
+
// We're trusting author input, but let's at least make sure it looks like a valid orderby statement
|
244 |
+
if ( isset( $arguments['orderby'] ) ) {
|
245 |
+
$attr['orderby'] = sanitize_sql_orderby( $arguments['orderby'] );
|
246 |
+
if ( ! $arguments['orderby'] )
|
247 |
+
unset( $arguments['orderby'] );
|
248 |
+
}
|
249 |
+
|
250 |
+
$use_children = empty( $query_arguments );
|
251 |
+
foreach ($arguments as $key => $value ) {
|
252 |
+
/*
|
253 |
+
* There are several "fallthru" cases in this switch statement that decide
|
254 |
+
* whether or not to limit the query to children of a specific post.
|
255 |
+
*/
|
256 |
+
$children_ok = true;
|
257 |
+
switch ( $key ) {
|
258 |
+
case 'post_parent':
|
259 |
+
if ( 'current' == strtolower( $value ) )
|
260 |
+
$value = $post->ID;
|
261 |
+
elseif ( 'all' == strtolower( $value ) ) {
|
262 |
+
$value = NULL;
|
263 |
+
$use_children = false;
|
264 |
+
}
|
265 |
+
// fallthru
|
266 |
+
case 'id':
|
267 |
+
case 'posts_per_page':
|
268 |
+
case 'posts_per_archive_page':
|
269 |
+
if ( is_numeric( $value ) ) {
|
270 |
+
$value = intval( $value );
|
271 |
+
if ( ! empty( $value ) ) {
|
272 |
+
$query_arguments[ $key ] = $value;
|
273 |
+
if ( ! $children_ok )
|
274 |
+
$use_children = false;
|
275 |
+
}
|
276 |
+
}
|
277 |
+
unset( $arguments[ $key ] );
|
278 |
+
break;
|
279 |
+
case 'meta_value_num':
|
280 |
+
$children_ok = false;
|
281 |
+
// fallthru
|
282 |
+
case 'offset':
|
283 |
+
if ( is_numeric( $value ) ) {
|
284 |
+
$query_arguments[ $key ] = intval( $value );
|
285 |
+
if ( ! $children_ok )
|
286 |
+
$use_children = false;
|
287 |
+
}
|
288 |
+
unset( $arguments[ $key ] );
|
289 |
+
break;
|
290 |
+
case 'paged':
|
291 |
+
if ( 'current' == strtolower( $value ) )
|
292 |
+
$query_arguments[ $key ] = (get_query_var('paged')) ? get_query_var('paged') : 1;
|
293 |
+
elseif ( is_numeric( $value ) )
|
294 |
+
$query_arguments[ $key ] = intval( $value );
|
295 |
+
unset( $arguments[ $key ] );
|
296 |
+
break;
|
297 |
+
case 'author':
|
298 |
+
case 'cat':
|
299 |
+
case 'tag_id':
|
300 |
+
if ( ! empty( $value ) ) {
|
301 |
+
if ( is_array( $value ) )
|
302 |
+
$query_arguments[ $key ] = array_filter( $value );
|
303 |
+
else
|
304 |
+
$query_arguments[ $key ] = array_filter( array_map( 'intval', explode( ",", $value ) ) );
|
305 |
+
|
306 |
+
if ( 1 == count( $query_arguments[ $key ] ) )
|
307 |
+
$query_arguments[ $key ] = $query_arguments[ $key ][0];
|
308 |
+
else
|
309 |
+
$query_arguments[ $key ] = implode(',', $query_arguments[ $key ] );
|
310 |
+
|
311 |
+
$use_children = false;
|
312 |
+
}
|
313 |
+
unset( $arguments[ $key ] );
|
314 |
+
break;
|
315 |
+
case 'category__and':
|
316 |
+
case 'category__in':
|
317 |
+
case 'category__not_in':
|
318 |
+
case 'tag__and':
|
319 |
+
case 'tag__in':
|
320 |
+
case 'tag__not_in':
|
321 |
+
$children_ok = false;
|
322 |
+
// fallthru
|
323 |
+
case 'include':
|
324 |
+
case 'exclude':
|
325 |
+
if ( ! empty( $value ) ) {
|
326 |
+
if ( is_array( $value ) )
|
327 |
+
$query_arguments[ $key ] = array_filter( $value );
|
328 |
+
else
|
329 |
+
$query_arguments[ $key ] = array_filter( array_map( 'intval', explode( ",", $value ) ) );
|
330 |
+
|
331 |
+
if ( ! $children_ok )
|
332 |
+
$use_children = false;
|
333 |
+
}
|
334 |
+
unset( $arguments[ $key ] );
|
335 |
+
break;
|
336 |
+
case 'tag_slug__and':
|
337 |
+
case 'tag_slug__in':
|
338 |
+
if ( ! empty( $value ) ) {
|
339 |
+
if ( is_array( $value ) )
|
340 |
+
$query_arguments[ $key ] = $value;
|
341 |
+
else
|
342 |
+
$query_arguments[ $key ] = array_filter( array_map( 'trim', explode( ",", $value ) ) );
|
343 |
+
|
344 |
+
$use_children = false;
|
345 |
+
}
|
346 |
+
unset( $arguments[ $key ] );
|
347 |
+
break;
|
348 |
+
case 'nopaging': // boolean
|
349 |
+
if ( ! empty( $value ) && ( 'false' != strtolower( $value ) ) )
|
350 |
+
$query_arguments[ $key ] = true;
|
351 |
+
unset( $arguments[ $key ] );
|
352 |
+
break;
|
353 |
+
case 'author_name':
|
354 |
+
case 'category_name':
|
355 |
+
case 'tag':
|
356 |
+
case 'meta_key':
|
357 |
+
case 'meta_value':
|
358 |
+
case 'meta_compare':
|
359 |
+
case 's':
|
360 |
+
$children_ok = false;
|
361 |
+
// fallthru
|
362 |
+
case 'post_type':
|
363 |
+
case 'post_status':
|
364 |
+
case 'post_mime_type':
|
365 |
+
case 'order':
|
366 |
+
case 'orderby':
|
367 |
+
if ( ! empty( $value ) ) {
|
368 |
+
$query_arguments[ $key ] = $value;
|
369 |
+
|
370 |
+
if ( ! $children_ok )
|
371 |
+
$use_children = false;
|
372 |
+
}
|
373 |
+
unset( $arguments[ $key ] );
|
374 |
+
break;
|
375 |
+
case 'meta_query':
|
376 |
+
if ( ! empty( $value ) ) {
|
377 |
+
if ( is_array( $value ) )
|
378 |
+
$query_arguments[ $key ] = $value;
|
379 |
+
else {
|
380 |
+
$function = @create_function('', 'return ' . $value . ';' );
|
381 |
+
|
382 |
+
if ( is_callable( $function ) )
|
383 |
+
$query_arguments[ $key ] = $function();
|
384 |
+
else
|
385 |
+
return '<p>ERROR: invalid mla_gallery meta_query = ' . var_export( $value, true ) . '</p>';
|
386 |
+
} // not array
|
387 |
+
|
388 |
+
$use_children = false;
|
389 |
+
}
|
390 |
+
unset( $arguments[ $key ] );
|
391 |
+
break;
|
392 |
+
default:
|
393 |
+
// ignore anything else
|
394 |
+
} // switch $key
|
395 |
+
} // foreach $arguments
|
396 |
+
|
397 |
+
/*
|
398 |
+
* Decide whether to use a "get_children" style query
|
399 |
+
*/
|
400 |
+
if ( $use_children && empty( $query_arguments['post_parent'] ) ) {
|
401 |
+
if ( empty( $query_arguments['id'] ) )
|
402 |
+
$query_arguments['post_parent'] = $post->ID;
|
403 |
+
else
|
404 |
+
$query_arguments['post_parent'] = $query_arguments['id'];
|
405 |
+
|
406 |
+
unset( $query_arguments['id'] );
|
407 |
+
}
|
408 |
+
|
409 |
+
if ( isset( $query_arguments['posts_per_page'] ) || isset( $query_arguments['posts_per_archive_page'] ) ||
|
410 |
+
isset( $query_arguments['paged'] ) || isset( $query_arguments['offset'] ) ) {
|
411 |
+
unset ($query_arguments['nopaging'] );
|
412 |
+
}
|
413 |
+
|
414 |
+
if ( isset( $query_arguments['orderby'] ) && ('rand' == $query_arguments['orderby'] ) )
|
415 |
+
unset ($query_arguments['order'] );
|
416 |
+
|
417 |
+
if ( isset( $query_arguments['order'] ) && ('rand' == $query_arguments['order'] ) )
|
418 |
+
unset ($query_arguments['orderby'] );
|
419 |
+
|
420 |
+
if ( isset( $query_arguments['post_mime_type'] ) && ('all' == strtolower( $query_arguments['post_mime_type'] ) ) )
|
421 |
+
unset ($query_arguments['post_mime_type'] );
|
422 |
+
|
423 |
+
$attachments = self::_get_attachments( $query_arguments );
|
424 |
+
if ( empty($attachments) )
|
425 |
+
return '';
|
426 |
+
|
427 |
+
if ( is_feed() ) {
|
428 |
+
$output = "\n";
|
429 |
+
foreach ( $attachments as $att_id => $attachment )
|
430 |
+
$output .= wp_get_attachment_link($att_id, $arguments['size'], true) . "\n";
|
431 |
+
return $output;
|
432 |
+
}
|
433 |
+
|
434 |
+
$id = $post->ID;
|
435 |
+
$itemtag = tag_escape( $arguments['itemtag'] );
|
436 |
+
$icontag = tag_escape( $arguments['icontag'] );
|
437 |
+
$captiontag = tag_escape( $arguments['captiontag'] );
|
438 |
+
$columns = intval( $arguments['columns']);
|
439 |
+
$itemwidth = $columns > 0 ? floor(100/$columns) : 100;
|
440 |
+
$float = is_rtl() ? 'right' : 'left';
|
441 |
+
|
442 |
+
$size = $arguments['size'];
|
443 |
+
if ( 'icon' == strtolower( $size) ) {
|
444 |
+
$size = array( 60, 60 );
|
445 |
+
$show_icon = true;
|
446 |
+
}
|
447 |
+
else
|
448 |
+
$show_icon = false;
|
449 |
+
|
450 |
+
$selector = "gallery-{$instance}";
|
451 |
+
|
452 |
+
$gallery_style = $gallery_div = '';
|
453 |
+
if ( apply_filters( 'use_default_gallery_style', true ) )
|
454 |
+
$gallery_style = "
|
455 |
+
<style type='text/css'>
|
456 |
+
#{$selector} {
|
457 |
+
margin: auto;
|
458 |
+
}
|
459 |
+
#{$selector} .gallery-item {
|
460 |
+
float: {$float};
|
461 |
+
margin-top: 10px;
|
462 |
+
text-align: center;
|
463 |
+
width: {$itemwidth}%;
|
464 |
+
}
|
465 |
+
#{$selector} img {
|
466 |
+
border: 2px solid #cfcfcf;
|
467 |
+
}
|
468 |
+
#{$selector} .gallery-caption {
|
469 |
+
margin-left: 0;
|
470 |
+
}
|
471 |
+
</style>
|
472 |
+
<!-- see gallery_shortcode() in wp-includes/media.php -->";
|
473 |
+
$size_class = sanitize_html_class( $size );
|
474 |
+
$gallery_div = "<div id='$selector' class='gallery galleryid-{$id} gallery-columns-{$columns} gallery-size-{$size_class}'>";
|
475 |
+
$output = apply_filters( 'gallery_style', $gallery_style . "\n\t\t" . $gallery_div );
|
476 |
+
|
477 |
+
$i = 0;
|
478 |
+
foreach ( $attachments as $id => $attachment ) {
|
479 |
+
$link = isset($arguments['link']) && 'file' == $arguments['link'] ? wp_get_attachment_link($attachment->ID, $size, false, $show_icon) : wp_get_attachment_link($attachment->ID, $size, true, $show_icon);
|
480 |
+
|
481 |
+
$output .= "<{$itemtag} class='gallery-item'>";
|
482 |
+
$output .= "
|
483 |
+
<{$icontag} class='gallery-icon'>
|
484 |
+
$link
|
485 |
+
</{$icontag}>";
|
486 |
+
$post_excerpt = esc_attr( trim( $attachment->post_excerpt ) );
|
487 |
+
if ( $captiontag && ! empty( $post_excerpt ) ) {
|
488 |
+
$output .= "
|
489 |
+
<{$captiontag} class='wp-caption-text gallery-caption'>
|
490 |
+
" . wptexturize($post_excerpt) . "
|
491 |
+
</{$captiontag}>";
|
492 |
+
}
|
493 |
+
$output .= "</{$itemtag}>";
|
494 |
+
if ( $columns > 0 && ++$i % $columns == 0 )
|
495 |
+
$output .= '<br style="clear: both" />';
|
496 |
+
}
|
497 |
+
|
498 |
+
$output .= "
|
499 |
+
<br style='clear: both;' />
|
500 |
+
</div>\n";
|
501 |
+
|
502 |
+
return $output;
|
503 |
+
}
|
504 |
+
|
505 |
+
/**
|
506 |
+
* Replaces /wp-includes/post.php function get_posts()
|
507 |
+
*
|
508 |
+
* @since .50
|
509 |
+
*
|
510 |
+
* @param array Attributes of the shortcode
|
511 |
+
*
|
512 |
+
* @return array List of attachments returned from WP_Query
|
513 |
+
*/
|
514 |
+
private static function _get_attachments( $args ) {
|
515 |
+
if ( ! empty($args['include']) ) {
|
516 |
+
$incposts = wp_parse_id_list( $args['include'] );
|
517 |
+
$args['posts_per_page'] = count($incposts); // only the number of posts included
|
518 |
+
$args['post__in'] = $incposts;
|
519 |
+
} elseif ( ! empty($args['exclude']) )
|
520 |
+
$args['post__not_in'] = wp_parse_id_list( $args['exclude'] );
|
521 |
+
|
522 |
+
$args['ignore_sticky_posts'] = true;
|
523 |
+
$args['no_found_rows'] = true;
|
524 |
+
|
525 |
+
$get_posts = new WP_Query;
|
526 |
+
return $get_posts->query($args);
|
527 |
+
|
528 |
+
}
|
529 |
+
} // Class MLAShortcodes
|
530 |
?>
|
index.php
CHANGED
@@ -6,7 +6,7 @@
|
|
6 |
* will the rest of the plugin be loaded and run.
|
7 |
*
|
8 |
* @package Media Library Assistant
|
9 |
-
* @version 0.
|
10 |
*/
|
11 |
|
12 |
/*
|
@@ -14,7 +14,7 @@ Plugin Name: Media Library Assistant
|
|
14 |
Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
|
15 |
Description: Provides several enhancements to the handling of images and files held in the WordPress Media Library.
|
16 |
Author: David Lingren
|
17 |
-
Version: 0.
|
18 |
Author URI: http://fairtradejudaica.org/our-story/staff/
|
19 |
*/
|
20 |
|
6 |
* will the rest of the plugin be loaded and run.
|
7 |
*
|
8 |
* @package Media Library Assistant
|
9 |
+
* @version 0.50
|
10 |
*/
|
11 |
|
12 |
/*
|
14 |
Plugin URI: http://fairtradejudaica.org/media-library-assistant-a-wordpress-plugin/
|
15 |
Description: Provides several enhancements to the handling of images and files held in the WordPress Media Library.
|
16 |
Author: David Lingren
|
17 |
+
Version: 0.50
|
18 |
Author URI: http://fairtradejudaica.org/our-story/staff/
|
19 |
*/
|
20 |
|
phpDocs/classes/MLA.html
CHANGED
@@ -725,7 +725,7 @@ for a single attachment.</h2>
|
|
725 |
<div class="row"><footer class="span12">
|
726 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
727 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
728 |
-
generated on 2012-10-
|
729 |
</div>
|
730 |
</body>
|
731 |
</html>
|
725 |
<div class="row"><footer class="span12">
|
726 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
727 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
728 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
729 |
</div>
|
730 |
</body>
|
731 |
</html>
|
phpDocs/classes/MLAData.html
CHANGED
@@ -178,7 +178,7 @@ the posts and postmeta tables, and all references to the attachment.</p></p>
|
|
178 |
</div>
|
179 |
<a name="mla_load_template" id="mla_load_template"></a><div class="element clickable method public mla_load_template" data-toggle="collapse" data-target=".mla_load_template .collapse">
|
180 |
<h2>Load an HTML template from a file</h2>
|
181 |
-
<pre>mla_load_template(string $
|
182 |
<div class="labels"></div>
|
183 |
<div class="row collapse"><div class="detail-description">
|
184 |
<p class="long_description"><p>Loads a template to a string or a multi-part template to an array.
|
@@ -190,11 +190,15 @@ where "key" becomes the key part of the array.</p></p>
|
|
190 |
</tr></table>
|
191 |
<h3>Parameters</h3>
|
192 |
<div class="subelement argument">
|
193 |
-
<h4>$
|
194 |
-
<code>string</code><p>Complete path and name of the template file</p></div>
|
|
|
|
|
|
|
|
|
195 |
<h3>Returns</h3>
|
196 |
<div class="subelement response">
|
197 |
-
<code>string</code><code>array</code><code>false</code><code>NULL</code>string for files that do not contain template divider comments, array for files containing template divider comments, false if file does not exist, NULL if file could not be loaded.</div>
|
198 |
</div></div>
|
199 |
</div>
|
200 |
<a name="mla_parse_template" id="mla_parse_template"></a><div class="element clickable method public mla_parse_template" data-toggle="collapse" data-target=".mla_parse_template .collapse">
|
@@ -419,7 +423,7 @@ any further logic required to translate those values is contained in the filters
|
|
419 |
<div class="row"><footer class="span12">
|
420 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
421 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
422 |
-
generated on 2012-10-
|
423 |
</div>
|
424 |
</body>
|
425 |
</html>
|
178 |
</div>
|
179 |
<a name="mla_load_template" id="mla_load_template"></a><div class="element clickable method public mla_load_template" data-toggle="collapse" data-target=".mla_load_template .collapse">
|
180 |
<h2>Load an HTML template from a file</h2>
|
181 |
+
<pre>mla_load_template(string $source, string $type) : string | array | false | NULL</pre>
|
182 |
<div class="labels"></div>
|
183 |
<div class="row collapse"><div class="detail-description">
|
184 |
<p class="long_description"><p>Loads a template to a string or a multi-part template to an array.
|
190 |
</tr></table>
|
191 |
<h3>Parameters</h3>
|
192 |
<div class="subelement argument">
|
193 |
+
<h4>$source</h4>
|
194 |
+
<code>string</code><p>Complete path and name of the template file, option name or the raw template</p></div>
|
195 |
+
<div class="subelement argument">
|
196 |
+
<h4>$type</h4>
|
197 |
+
<code>string</code><p>Type of template source; 'file', 'option', 'string'</p>
|
198 |
+
</div>
|
199 |
<h3>Returns</h3>
|
200 |
<div class="subelement response">
|
201 |
+
<code>string</code><code>array</code><code>false</code><code>NULL</code>string for files that do not contain template divider comments, array for files containing template divider comments, false if file or option does not exist, NULL if file could not be loaded.</div>
|
202 |
</div></div>
|
203 |
</div>
|
204 |
<a name="mla_parse_template" id="mla_parse_template"></a><div class="element clickable method public mla_parse_template" data-toggle="collapse" data-target=".mla_parse_template .collapse">
|
423 |
<div class="row"><footer class="span12">
|
424 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
425 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
426 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
427 |
</div>
|
428 |
</body>
|
429 |
</html>
|
phpDocs/classes/MLAObjects.html
CHANGED
@@ -167,7 +167,7 @@ which replaces the "Posts" column with an equivalent "Attachments" column.</h2>
|
|
167 |
<div class="row"><footer class="span12">
|
168 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
169 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
170 |
-
generated on 2012-10-
|
171 |
</div>
|
172 |
</body>
|
173 |
</html>
|
167 |
<div class="row"><footer class="span12">
|
168 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
169 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
170 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
171 |
</div>
|
172 |
</body>
|
173 |
</html>
|
phpDocs/classes/MLASettings.html
CHANGED
@@ -67,6 +67,7 @@ settings are being updated or reset."><span class="description">Determine MLA su
|
|
67 |
settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a></li>
|
68 |
<li class="method public "><a href="#mla_update_option" title="mla_update_option :: Add or update the stored value of a defined MLA option"><span class="description">Add or update the stored value of a defined MLA option</span><pre>mla_update_option()</pre></a></li>
|
69 |
<li class="nav-header private">» Private</li>
|
|
|
70 |
<li class="method private "><a href="#_reset_settings" title="_reset_settings :: Delete saved settings, restoring default values"><span class="description">Delete saved settings, restoring default values</span><pre>_reset_settings()</pre></a></li>
|
71 |
<li class="method private "><a href="#_save_settings" title="_save_settings :: Save settings to the options table"><span class="description">Save settings to the options table</span><pre>_save_settings()</pre></a></li>
|
72 |
<li class="method private "><a href="#_taxonomy_handler" title="_taxonomy_handler :: Render and manage other taxonomy support options, e.g., Categories and Post Tags"><span class="description">Render and manage other taxonomy support options, e.g., Categories and Post Tags</span><pre>_taxonomy_handler()</pre></a></li>
|
@@ -278,6 +279,19 @@ settings are being updated or reset.</h2>
|
|
278 |
<code>boolean</code>True if the value was changed or false if the update failed</div>
|
279 |
</div></div>
|
280 |
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
281 |
<a name="_reset_settings" id="_reset_settings"></a><div class="element clickable method private _reset_settings" data-toggle="collapse" data-target="._reset_settings .collapse">
|
282 |
<h2>Delete saved settings, restoring default values</h2>
|
283 |
<pre>_reset_settings(array $template_array) : array</pre>
|
@@ -428,7 +442,7 @@ reset => reset function for 'custom' options; returns nothing. Usage:
|
|
428 |
<div class="row"><footer class="span12">
|
429 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
430 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
431 |
-
generated on 2012-10-
|
432 |
</div>
|
433 |
</body>
|
434 |
</html>
|
67 |
settings are being updated or reset.</span><pre>mla_taxonomy_support()</pre></a></li>
|
68 |
<li class="method public "><a href="#mla_update_option" title="mla_update_option :: Add or update the stored value of a defined MLA option"><span class="description">Add or update the stored value of a defined MLA option</span><pre>mla_update_option()</pre></a></li>
|
69 |
<li class="nav-header private">» Private</li>
|
70 |
+
<li class="method private "><a href="#_create_alt_text_view" title="_create_alt_text_view :: Add a view to the database to support sorting the listing on 'ALT Text'"><span class="description">Add a view to the database to support sorting the listing on 'ALT Text'</span><pre>_create_alt_text_view()</pre></a></li>
|
71 |
<li class="method private "><a href="#_reset_settings" title="_reset_settings :: Delete saved settings, restoring default values"><span class="description">Delete saved settings, restoring default values</span><pre>_reset_settings()</pre></a></li>
|
72 |
<li class="method private "><a href="#_save_settings" title="_save_settings :: Save settings to the options table"><span class="description">Save settings to the options table</span><pre>_save_settings()</pre></a></li>
|
73 |
<li class="method private "><a href="#_taxonomy_handler" title="_taxonomy_handler :: Render and manage other taxonomy support options, e.g., Categories and Post Tags"><span class="description">Render and manage other taxonomy support options, e.g., Categories and Post Tags</span><pre>_taxonomy_handler()</pre></a></li>
|
279 |
<code>boolean</code>True if the value was changed or false if the update failed</div>
|
280 |
</div></div>
|
281 |
</div>
|
282 |
+
<a name="_create_alt_text_view" id="_create_alt_text_view"></a><div class="element clickable method private _create_alt_text_view" data-toggle="collapse" data-target="._create_alt_text_view .collapse">
|
283 |
+
<h2>Add a view to the database to support sorting the listing on 'ALT Text'</h2>
|
284 |
+
<pre>_create_alt_text_view() : void</pre>
|
285 |
+
<div class="labels"></div>
|
286 |
+
<div class="row collapse"><div class="detail-description">
|
287 |
+
<p class="long_description"><p>This function is called on each plugin invocation because the plugin upgrade process
|
288 |
+
does not call the activation hook.</p></p>
|
289 |
+
<table class="table table-bordered"><tr>
|
290 |
+
<th>since</th>
|
291 |
+
<td>0.50</td>
|
292 |
+
</tr></table>
|
293 |
+
</div></div>
|
294 |
+
</div>
|
295 |
<a name="_reset_settings" id="_reset_settings"></a><div class="element clickable method private _reset_settings" data-toggle="collapse" data-target="._reset_settings .collapse">
|
296 |
<h2>Delete saved settings, restoring default values</h2>
|
297 |
<pre>_reset_settings(array $template_array) : array</pre>
|
442 |
<div class="row"><footer class="span12">
|
443 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
444 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
445 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
446 |
</div>
|
447 |
</body>
|
448 |
</html>
|
phpDocs/classes/MLAShortcodes.html
CHANGED
@@ -54,6 +54,9 @@
|
|
54 |
<i class="icon-custom icon-method"></i> Methods</li>
|
55 |
<li class="method public "><a href="#initialize" title="initialize :: Initialization function, similar to __construct()"><span class="description">Initialization function, similar to __construct()</span><pre>initialize()</pre></a></li>
|
56 |
<li class="method public "><a href="#mla_attachment_list_shortcode" title="mla_attachment_list_shortcode :: WordPress Shortcode; renders a complete list of all attachments and references to them"><span class="description">WordPress Shortcode; renders a complete list of all attachments and references to them</span><pre>mla_attachment_list_shortcode()</pre></a></li>
|
|
|
|
|
|
|
57 |
</ul>
|
58 |
</div>
|
59 |
<div class="span8">
|
@@ -106,6 +109,46 @@
|
|
106 |
</tr></table>
|
107 |
</div></div>
|
108 |
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
109 |
</div>
|
110 |
</div>
|
111 |
</div>
|
@@ -113,7 +156,7 @@
|
|
113 |
<div class="row"><footer class="span12">
|
114 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
115 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
116 |
-
generated on 2012-10-
|
117 |
</div>
|
118 |
</body>
|
119 |
</html>
|
54 |
<i class="icon-custom icon-method"></i> Methods</li>
|
55 |
<li class="method public "><a href="#initialize" title="initialize :: Initialization function, similar to __construct()"><span class="description">Initialization function, similar to __construct()</span><pre>initialize()</pre></a></li>
|
56 |
<li class="method public "><a href="#mla_attachment_list_shortcode" title="mla_attachment_list_shortcode :: WordPress Shortcode; renders a complete list of all attachments and references to them"><span class="description">WordPress Shortcode; renders a complete list of all attachments and references to them</span><pre>mla_attachment_list_shortcode()</pre></a></li>
|
57 |
+
<li class="method public "><a href="#mla_gallery_shortcode" title="mla_gallery_shortcode :: The MLA Gallery shortcode."><span class="description">The MLA Gallery shortcode.</span><pre>mla_gallery_shortcode()</pre></a></li>
|
58 |
+
<li class="nav-header private">» Private</li>
|
59 |
+
<li class="method private "><a href="#_get_attachments" title="_get_attachments :: Replaces /wp-includes/post.php function get_posts()"><span class="description">Replaces /wp-includes/post.php function get_posts()</span><pre>_get_attachments()</pre></a></li>
|
60 |
</ul>
|
61 |
</div>
|
62 |
<div class="span8">
|
109 |
</tr></table>
|
110 |
</div></div>
|
111 |
</div>
|
112 |
+
<a name="mla_gallery_shortcode" id="mla_gallery_shortcode"></a><div class="element clickable method public mla_gallery_shortcode" data-toggle="collapse" data-target=".mla_gallery_shortcode .collapse">
|
113 |
+
<h2>The MLA Gallery shortcode.</h2>
|
114 |
+
<pre>mla_gallery_shortcode(array $attr) : string</pre>
|
115 |
+
<div class="labels"></div>
|
116 |
+
<div class="row collapse"><div class="detail-description">
|
117 |
+
<p class="long_description"><p>This is a superset of the WordPress Gallery shortcode for displaying images on a post,
|
118 |
+
page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode.
|
119 |
+
Enhancements include many additional selection parameters and full taxonomy support.</p></p>
|
120 |
+
<table class="table table-bordered"><tr>
|
121 |
+
<th>since</th>
|
122 |
+
<td>.50</td>
|
123 |
+
</tr></table>
|
124 |
+
<h3>Parameters</h3>
|
125 |
+
<div class="subelement argument">
|
126 |
+
<h4>$attr</h4>
|
127 |
+
<code>array</code><p>Attributes of the shortcode.</p></div>
|
128 |
+
<h3>Returns</h3>
|
129 |
+
<div class="subelement response">
|
130 |
+
<code>string</code>HTML content to display gallery.</div>
|
131 |
+
</div></div>
|
132 |
+
</div>
|
133 |
+
<a name="_get_attachments" id="_get_attachments"></a><div class="element clickable method private _get_attachments" data-toggle="collapse" data-target="._get_attachments .collapse">
|
134 |
+
<h2>Replaces /wp-includes/post.php function get_posts()</h2>
|
135 |
+
<pre>_get_attachments(array $args) : array</pre>
|
136 |
+
<div class="labels"></div>
|
137 |
+
<div class="row collapse"><div class="detail-description">
|
138 |
+
<p class="long_description"></p>
|
139 |
+
<table class="table table-bordered"><tr>
|
140 |
+
<th>since</th>
|
141 |
+
<td>.50</td>
|
142 |
+
</tr></table>
|
143 |
+
<h3>Parameters</h3>
|
144 |
+
<div class="subelement argument">
|
145 |
+
<h4>$args</h4>
|
146 |
+
<code>array</code><p>Attributes of the shortcode</p></div>
|
147 |
+
<h3>Returns</h3>
|
148 |
+
<div class="subelement response">
|
149 |
+
<code>array</code>List of attachments returned from WP_Query</div>
|
150 |
+
</div></div>
|
151 |
+
</div>
|
152 |
</div>
|
153 |
</div>
|
154 |
</div>
|
156 |
<div class="row"><footer class="span12">
|
157 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
158 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
159 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
160 |
</div>
|
161 |
</body>
|
162 |
</html>
|
phpDocs/classes/MLATest.html
CHANGED
@@ -130,7 +130,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
|
|
130 |
<div class="row"><footer class="span12">
|
131 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
132 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
133 |
-
generated on 2012-10-
|
134 |
</div>
|
135 |
</body>
|
136 |
</html>
|
130 |
<div class="row"><footer class="span12">
|
131 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
132 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
133 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
134 |
</div>
|
135 |
</body>
|
136 |
</html>
|
phpDocs/classes/MLA_List_Table.html
CHANGED
@@ -923,7 +923,7 @@ sorted by that column. This is computed each time the table is displayed.</p></p
|
|
923 |
<div class="row"><footer class="span12">
|
924 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
925 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
926 |
-
generated on 2012-10-
|
927 |
</div>
|
928 |
</body>
|
929 |
</html>
|
923 |
<div class="row"><footer class="span12">
|
924 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
925 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
926 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
927 |
</div>
|
928 |
</body>
|
929 |
</html>
|
phpDocs/deprecated.html
CHANGED
@@ -62,7 +62,7 @@
|
|
62 |
<div class="row"><footer class="span12">
|
63 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
64 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
65 |
-
generated on 2012-10-
|
66 |
</div>
|
67 |
</body>
|
68 |
</html>
|
62 |
<div class="row"><footer class="span12">
|
63 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
64 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
65 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
66 |
</div>
|
67 |
</body>
|
68 |
</html>
|
phpDocs/errors.html
CHANGED
@@ -74,7 +74,7 @@
|
|
74 |
<div class="row"><footer class="span12">
|
75 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
76 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
77 |
-
generated on 2012-10-
|
78 |
</div>
|
79 |
</body>
|
80 |
</html>
|
74 |
<div class="row"><footer class="span12">
|
75 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
76 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
77 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
78 |
</div>
|
79 |
</body>
|
80 |
</html>
|
phpDocs/graph_class.html
CHANGED
@@ -59,7 +59,7 @@
|
|
59 |
</script><div class="row"><footer class="span12">
|
60 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
61 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
62 |
-
generated on 2012-10-
|
63 |
</div>
|
64 |
</body>
|
65 |
</html>
|
59 |
</script><div class="row"><footer class="span12">
|
60 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
61 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
62 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
63 |
</div>
|
64 |
</body>
|
65 |
</html>
|
phpDocs/index.html
CHANGED
@@ -79,7 +79,7 @@
|
|
79 |
<div class="row"><footer class="span12">
|
80 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
81 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
82 |
-
generated on 2012-10-
|
83 |
</div>
|
84 |
</body>
|
85 |
</html>
|
79 |
<div class="row"><footer class="span12">
|
80 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
81 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
82 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
83 |
</div>
|
84 |
</body>
|
85 |
</html>
|
phpDocs/markers.html
CHANGED
@@ -64,7 +64,7 @@
|
|
64 |
<div class="row"><footer class="span12">
|
65 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
66 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
67 |
-
generated on 2012-10-
|
68 |
</div>
|
69 |
</body>
|
70 |
</html>
|
64 |
<div class="row"><footer class="span12">
|
65 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
66 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
67 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
68 |
</div>
|
69 |
</body>
|
70 |
</html>
|
phpDocs/namespaces/global.html
CHANGED
@@ -159,7 +159,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
|
|
159 |
<div class="row"><footer class="span12">
|
160 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
161 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
162 |
-
generated on 2012-10-
|
163 |
</div>
|
164 |
</body>
|
165 |
</html>
|
159 |
<div class="row"><footer class="span12">
|
160 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
161 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
162 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
163 |
</div>
|
164 |
</body>
|
165 |
</html>
|
phpDocs/packages/Media Library Assistant.html
CHANGED
@@ -179,7 +179,7 @@ to ensure the plugin can run in the current WordPress envrionment.</p>
|
|
179 |
<div class="row"><footer class="span12">
|
180 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
181 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
182 |
-
generated on 2012-10-
|
183 |
</div>
|
184 |
</body>
|
185 |
</html>
|
179 |
<div class="row"><footer class="span12">
|
180 |
Template is built using <a href="http://twitter.github.com/bootstrap/">Twitter Bootstrap 2</a> and icons provided by <a href="http://glyphicons.com/">Glyphicons</a>.<br>
|
181 |
Documentation is powered by <a href="http://www.phpdoc.org/">phpDocumentor 2.0.0a8</a> and<br>
|
182 |
+
generated on 2012-10-13T19:50:41-07:00.<br></footer></div>
|
183 |
</div>
|
184 |
</body>
|
185 |
</html>
|
phpDocs/structure.xml
CHANGED
@@ -1,6 +1,6 @@
|
|
1 |
<?xml version="1.0" encoding="utf-8"?>
|
2 |
<project version="2.0.0a8" title="Media Library Assistant">
|
3 |
-
<file path="includes\class-mla-data.php" hash="
|
4 |
<docblock line="2">
|
5 |
<description><![CDATA[Database and template file access for MLA needs]]></description>
|
6 |
<long-description><![CDATA[]]></long-description>
|
@@ -18,16 +18,16 @@ Templates separate HTML markup from PHP code for easier maintenance and localiza
|
|
18 |
<tag line="9" name="package" description="Media Library Assistant"/>
|
19 |
<tag line="9" name="since" description="0.1"/>
|
20 |
</docblock>
|
21 |
-
<property final="false" static="true" visibility="private" line="
|
22 |
<name>$query_parameters</name>
|
23 |
<default><![CDATA[array()]]></default>
|
24 |
-
<docblock line="
|
25 |
<description><![CDATA[WP_Query filter "parameters"]]></description>
|
26 |
<long-description><![CDATA[<p>This array defines parameters for the query's join, where and orderby filters.
|
27 |
The parameters are set up in the _prepare_list_table_query function, and
|
28 |
any further logic required to translate those values is contained in the filters.</p>]]></long-description>
|
29 |
-
<tag line="
|
30 |
-
<tag line="
|
31 |
<type by_reference="false">array</type>
|
32 |
</tag>
|
33 |
</docblock>
|
@@ -41,7 +41,7 @@ any further logic required to translate those values is contained in the filters
|
|
41 |
<tag line="19" name="since" description="0.1"/>
|
42 |
</docblock>
|
43 |
</method>
|
44 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
45 |
<name>mla_load_template</name>
|
46 |
<full_name>mla_load_template</full_name>
|
47 |
<docblock line="28">
|
@@ -50,314 +50,322 @@ any further logic required to translate those values is contained in the filters
|
|
50 |
Multi-part templates are divided by comments of the form <!-- template="key" -->,
|
51 |
where "key" becomes the key part of the array.</p>]]></long-description>
|
52 |
<tag line="28" name="since" description="0.1"/>
|
53 |
-
<tag line="28" name="param" description="Complete path and name of the template file" type="string" variable="$
|
54 |
<type by_reference="false">string</type>
|
55 |
</tag>
|
56 |
-
<tag line="28" name="
|
|
|
|
|
|
|
57 |
<type by_reference="false">string</type>
|
58 |
<type by_reference="false">array</type>
|
59 |
<type by_reference="false">false</type>
|
60 |
<type by_reference="false">NULL</type>
|
61 |
</tag>
|
62 |
</docblock>
|
63 |
-
<argument line="
|
64 |
-
<name>$
|
65 |
<default><![CDATA[]]></default>
|
66 |
<type/>
|
67 |
</argument>
|
|
|
|
|
|
|
|
|
|
|
68 |
</method>
|
69 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
70 |
<name>mla_parse_template</name>
|
71 |
<full_name>mla_parse_template</full_name>
|
72 |
-
<docblock line="
|
73 |
<description><![CDATA[Expand a template, replacing place holders with their values]]></description>
|
74 |
<long-description><![CDATA[<p>A simple parsing function for basic templating.</p>]]></long-description>
|
75 |
-
<tag line="
|
76 |
-
<tag line="
|
77 |
<type by_reference="false">string</type>
|
78 |
</tag>
|
79 |
-
<tag line="
|
80 |
<type by_reference="false">array</type>
|
81 |
</tag>
|
82 |
-
<tag line="
|
83 |
<type by_reference="false">string</type>
|
84 |
</tag>
|
85 |
</docblock>
|
86 |
-
<argument line="
|
87 |
<name>$tpl</name>
|
88 |
<default><![CDATA[]]></default>
|
89 |
<type/>
|
90 |
</argument>
|
91 |
-
<argument line="
|
92 |
<name>$hash</name>
|
93 |
<default><![CDATA[]]></default>
|
94 |
<type/>
|
95 |
</argument>
|
96 |
</method>
|
97 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
98 |
<name>mla_count_list_table_items</name>
|
99 |
<full_name>mla_count_list_table_items</full_name>
|
100 |
-
<docblock line="
|
101 |
<description><![CDATA[Get the total number of attachment posts]]></description>
|
102 |
<long-description><![CDATA[]]></long-description>
|
103 |
-
<tag line="
|
104 |
-
<tag line="
|
105 |
<type by_reference="false">array</type>
|
106 |
</tag>
|
107 |
-
<tag line="
|
108 |
<type by_reference="false">integer</type>
|
109 |
</tag>
|
110 |
</docblock>
|
111 |
-
<argument line="
|
112 |
<name>$request</name>
|
113 |
<default><![CDATA[]]></default>
|
114 |
<type/>
|
115 |
</argument>
|
116 |
</method>
|
117 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
118 |
<name>mla_query_list_table_items</name>
|
119 |
<full_name>mla_query_list_table_items</full_name>
|
120 |
-
<docblock line="
|
121 |
<description><![CDATA[Retrieve attachment objects for list table display]]></description>
|
122 |
<long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
|
123 |
Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
|
124 |
-
<tag line="
|
125 |
-
<tag line="
|
126 |
<type by_reference="false">array</type>
|
127 |
</tag>
|
128 |
-
<tag line="
|
129 |
<type by_reference="false">int</type>
|
130 |
</tag>
|
131 |
-
<tag line="
|
132 |
<type by_reference="false">int</type>
|
133 |
</tag>
|
134 |
-
<tag line="
|
135 |
<type by_reference="false">array</type>
|
136 |
</tag>
|
137 |
</docblock>
|
138 |
-
<argument line="
|
139 |
<name>$request</name>
|
140 |
<default><![CDATA[]]></default>
|
141 |
<type/>
|
142 |
</argument>
|
143 |
-
<argument line="
|
144 |
<name>$offset</name>
|
145 |
<default><![CDATA[]]></default>
|
146 |
<type/>
|
147 |
</argument>
|
148 |
-
<argument line="
|
149 |
<name>$count</name>
|
150 |
<default><![CDATA[]]></default>
|
151 |
<type/>
|
152 |
</argument>
|
153 |
</method>
|
154 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
155 |
<name>_prepare_list_table_query</name>
|
156 |
<full_name>_prepare_list_table_query</full_name>
|
157 |
-
<docblock line="
|
158 |
<description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
|
159 |
<long-description><![CDATA[<p>Prepare the arguments for WP_Query.
|
160 |
Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
|
161 |
-
<tag line="
|
162 |
-
<tag line="
|
163 |
<type by_reference="false">array</type>
|
164 |
</tag>
|
165 |
-
<tag line="
|
166 |
<type by_reference="false">int</type>
|
167 |
</tag>
|
168 |
-
<tag line="
|
169 |
<type by_reference="false">int</type>
|
170 |
</tag>
|
171 |
-
<tag line="
|
172 |
<type by_reference="false">array</type>
|
173 |
</tag>
|
174 |
</docblock>
|
175 |
-
<argument line="
|
176 |
<name>$raw_request</name>
|
177 |
<default><![CDATA[]]></default>
|
178 |
<type/>
|
179 |
</argument>
|
180 |
-
<argument line="
|
181 |
<name>$offset</name>
|
182 |
<default><![CDATA[0]]></default>
|
183 |
<type/>
|
184 |
</argument>
|
185 |
-
<argument line="
|
186 |
<name>$count</name>
|
187 |
<default><![CDATA[0]]></default>
|
188 |
<type/>
|
189 |
</argument>
|
190 |
</method>
|
191 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
192 |
<name>_execute_list_table_query</name>
|
193 |
<full_name>_execute_list_table_query</full_name>
|
194 |
-
<docblock line="
|
195 |
<description><![CDATA[Add filters, run query, remove filters]]></description>
|
196 |
<long-description><![CDATA[]]></long-description>
|
197 |
-
<tag line="
|
198 |
-
<tag line="
|
199 |
<type by_reference="false">array</type>
|
200 |
</tag>
|
201 |
-
<tag line="
|
202 |
<type by_reference="false">object</type>
|
203 |
</tag>
|
204 |
</docblock>
|
205 |
-
<argument line="
|
206 |
<name>$request</name>
|
207 |
<default><![CDATA[]]></default>
|
208 |
<type/>
|
209 |
</argument>
|
210 |
</method>
|
211 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
212 |
<name>mla_query_posts_join_filter</name>
|
213 |
<full_name>mla_query_posts_join_filter</full_name>
|
214 |
-
<docblock line="
|
215 |
<description><![CDATA[Adds a JOIN clause, if required]]></description>
|
216 |
<long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
|
217 |
-
<tag line="
|
218 |
-
<tag line="
|
219 |
<type by_reference="false">string</type>
|
220 |
</tag>
|
221 |
-
<tag line="
|
222 |
<type by_reference="false">string</type>
|
223 |
</tag>
|
224 |
</docblock>
|
225 |
-
<argument line="
|
226 |
<name>$join_clause</name>
|
227 |
<default><![CDATA[]]></default>
|
228 |
<type/>
|
229 |
</argument>
|
230 |
</method>
|
231 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
232 |
<name>mla_query_posts_where_filter</name>
|
233 |
<full_name>mla_query_posts_where_filter</full_name>
|
234 |
-
<docblock line="
|
235 |
<description><![CDATA[Adds a WHERE clause for detached items]]></description>
|
236 |
<long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
|
237 |
Defined as public because it's a filter.</p>]]></long-description>
|
238 |
-
<tag line="
|
239 |
-
<tag line="
|
240 |
<type by_reference="false">string</type>
|
241 |
</tag>
|
242 |
-
<tag line="
|
243 |
<type by_reference="false">string</type>
|
244 |
</tag>
|
245 |
</docblock>
|
246 |
-
<argument line="
|
247 |
<name>$where_clause</name>
|
248 |
<default><![CDATA[]]></default>
|
249 |
<type/>
|
250 |
</argument>
|
251 |
</method>
|
252 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
253 |
<name>mla_query_posts_orderby_filter</name>
|
254 |
<full_name>mla_query_posts_orderby_filter</full_name>
|
255 |
-
<docblock line="
|
256 |
<description><![CDATA[Adds a ORDERBY clause, if required]]></description>
|
257 |
<long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
|
258 |
Defined as public because it's a filter.</p>]]></long-description>
|
259 |
-
<tag line="
|
260 |
-
<tag line="
|
261 |
<type by_reference="false">string</type>
|
262 |
</tag>
|
263 |
-
<tag line="
|
264 |
<type by_reference="false">string</type>
|
265 |
</tag>
|
266 |
</docblock>
|
267 |
-
<argument line="
|
268 |
<name>$orderby_clause</name>
|
269 |
<default><![CDATA[]]></default>
|
270 |
<type/>
|
271 |
</argument>
|
272 |
</method>
|
273 |
-
<method final="false" abstract="false" static="false" visibility="public" namespace="global" line="
|
274 |
<name>mla_get_attachment_by_id</name>
|
275 |
<full_name>mla_get_attachment_by_id</full_name>
|
276 |
-
<docblock line="
|
277 |
<description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
|
278 |
<long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
|
279 |
the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
|
280 |
-
<tag line="
|
281 |
-
<tag line="
|
282 |
<type by_reference="false">int</type>
|
283 |
</tag>
|
284 |
-
<tag line="
|
285 |
<type by_reference="false">NULL</type>
|
286 |
<type by_reference="false">array</type>
|
287 |
</tag>
|
288 |
</docblock>
|
289 |
-
<argument line="
|
290 |
<name>$post_id</name>
|
291 |
<default><![CDATA[]]></default>
|
292 |
<type/>
|
293 |
</argument>
|
294 |
</method>
|
295 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
296 |
<name>mla_fetch_attachment_references</name>
|
297 |
<full_name>mla_fetch_attachment_references</full_name>
|
298 |
-
<docblock line="
|
299 |
<description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
|
300 |
<long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
|
301 |
as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
|
302 |
-
<tag line="
|
303 |
-
<tag line="
|
304 |
<type by_reference="false">int</type>
|
305 |
</tag>
|
306 |
-
<tag line="
|
307 |
<type by_reference="false">int</type>
|
308 |
</tag>
|
309 |
-
<tag line="
|
310 |
<type by_reference="false">array</type>
|
311 |
</tag>
|
312 |
</docblock>
|
313 |
-
<argument line="
|
314 |
<name>$ID</name>
|
315 |
<default><![CDATA[]]></default>
|
316 |
<type/>
|
317 |
</argument>
|
318 |
-
<argument line="
|
319 |
<name>$parent</name>
|
320 |
<default><![CDATA[]]></default>
|
321 |
<type/>
|
322 |
</argument>
|
323 |
</method>
|
324 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
325 |
<name>_fetch_attachment_parent_data</name>
|
326 |
<full_name>_fetch_attachment_parent_data</full_name>
|
327 |
-
<docblock line="
|
328 |
<description><![CDATA[Returns information about an attachment's parent, if found]]></description>
|
329 |
<long-description><![CDATA[]]></long-description>
|
330 |
-
<tag line="
|
331 |
-
<tag line="
|
332 |
<type by_reference="false">int</type>
|
333 |
</tag>
|
334 |
-
<tag line="
|
335 |
<type by_reference="false">array</type>
|
336 |
</tag>
|
337 |
</docblock>
|
338 |
-
<argument line="
|
339 |
<name>$parent_id</name>
|
340 |
<default><![CDATA[]]></default>
|
341 |
<type/>
|
342 |
</argument>
|
343 |
</method>
|
344 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
345 |
<name>_fetch_attachment_metadata</name>
|
346 |
<full_name>_fetch_attachment_metadata</full_name>
|
347 |
-
<docblock line="
|
348 |
<description><![CDATA[Fetch and filter meta data for an attachment]]></description>
|
349 |
<long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
|
350 |
are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
|
351 |
a string containing the first array element.</p>]]></long-description>
|
352 |
-
<tag line="
|
353 |
-
<tag line="
|
354 |
<type by_reference="false">int</type>
|
355 |
</tag>
|
356 |
-
<tag line="
|
357 |
<type by_reference="false">array</type>
|
358 |
</tag>
|
359 |
</docblock>
|
360 |
-
<argument line="
|
361 |
<name>$post_id</name>
|
362 |
<default><![CDATA[]]></default>
|
363 |
<type/>
|
@@ -1162,7 +1170,7 @@ $this->set_pagination_args().</p>]]></long-description>
|
|
1162 |
</method>
|
1163 |
</class>
|
1164 |
</file>
|
1165 |
-
<file path="includes\class-mla-main.php" hash="
|
1166 |
<docblock line="2">
|
1167 |
<description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
|
1168 |
<long-description><![CDATA[]]></long-description>
|
@@ -1199,7 +1207,7 @@ of images and files held in the WordPress Media Library.]]></description>
|
|
1199 |
<constant namespace="global" line="41" package="Media Library Assistant">
|
1200 |
<name>CURRENT_MLA_VERSION</name>
|
1201 |
<full_name>CURRENT_MLA_VERSION</full_name>
|
1202 |
-
<value><![CDATA['0.
|
1203 |
<docblock line="34">
|
1204 |
<description><![CDATA[Current version number]]></description>
|
1205 |
<long-description><![CDATA[]]></long-description>
|
@@ -1447,397 +1455,397 @@ of images and files held in the WordPress Media Library.]]></description>
|
|
1447 |
<type/>
|
1448 |
</argument>
|
1449 |
</method>
|
1450 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1451 |
<name>mla_admin_menu_action</name>
|
1452 |
<full_name>mla_admin_menu_action</full_name>
|
1453 |
-
<docblock line="
|
1454 |
<description><![CDATA[Add the submenu pages]]></description>
|
1455 |
<long-description><![CDATA[<p>Add a submenu page in the "Media" section,
|
1456 |
add submenu page(s) for attachment taxonomies,
|
1457 |
add filter to clean up taxonomy submenu labels
|
1458 |
add settings page in the "Settings" section,
|
1459 |
add settings link in the Plugins section entry for MLA.</p>]]></long-description>
|
1460 |
-
<tag line="
|
1461 |
-
<tag line="
|
1462 |
<type by_reference="false">void</type>
|
1463 |
</tag>
|
1464 |
</docblock>
|
1465 |
</method>
|
1466 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1467 |
<name>mla_add_menu_options</name>
|
1468 |
<full_name>mla_add_menu_options</full_name>
|
1469 |
-
<docblock line="
|
1470 |
<description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
|
1471 |
<long-description><![CDATA[]]></long-description>
|
1472 |
-
<tag line="
|
1473 |
-
<tag line="
|
1474 |
<type by_reference="false">void</type>
|
1475 |
</tag>
|
1476 |
</docblock>
|
1477 |
</method>
|
1478 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1479 |
<name>mla_screen_options_show_screen_filter</name>
|
1480 |
<full_name>mla_screen_options_show_screen_filter</full_name>
|
1481 |
-
<docblock line="
|
1482 |
<description><![CDATA[Only show screen options on the table-list screen]]></description>
|
1483 |
<long-description><![CDATA[]]></long-description>
|
1484 |
-
<tag line="
|
1485 |
-
<tag line="
|
1486 |
<type by_reference="false">boolean</type>
|
1487 |
</tag>
|
1488 |
-
<tag line="
|
1489 |
<type by_reference="false">string</type>
|
1490 |
</tag>
|
1491 |
-
<tag line="
|
1492 |
<type by_reference="false">boolean</type>
|
1493 |
</tag>
|
1494 |
</docblock>
|
1495 |
-
<argument line="
|
1496 |
<name>$show_screen</name>
|
1497 |
<default><![CDATA[]]></default>
|
1498 |
<type/>
|
1499 |
</argument>
|
1500 |
-
<argument line="
|
1501 |
<name>$this_screen</name>
|
1502 |
<default><![CDATA[]]></default>
|
1503 |
<type/>
|
1504 |
</argument>
|
1505 |
</method>
|
1506 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1507 |
<name>mla_set_screen_option_filter</name>
|
1508 |
<full_name>mla_set_screen_option_filter</full_name>
|
1509 |
-
<docblock line="
|
1510 |
<description><![CDATA[Save the "Entries per page" option set by this user]]></description>
|
1511 |
<long-description><![CDATA[]]></long-description>
|
1512 |
-
<tag line="
|
1513 |
-
<tag line="
|
1514 |
<type by_reference="false">boolean</type>
|
1515 |
</tag>
|
1516 |
-
<tag line="
|
1517 |
<type by_reference="false">string</type>
|
1518 |
</tag>
|
1519 |
-
<tag line="
|
1520 |
<type by_reference="false">string</type>
|
1521 |
</tag>
|
1522 |
-
<tag line="
|
1523 |
<type by_reference="false">string</type>
|
1524 |
<type by_reference="false">void</type>
|
1525 |
</tag>
|
1526 |
</docblock>
|
1527 |
-
<argument line="
|
1528 |
<name>$status</name>
|
1529 |
<default><![CDATA[]]></default>
|
1530 |
<type/>
|
1531 |
</argument>
|
1532 |
-
<argument line="
|
1533 |
<name>$option</name>
|
1534 |
<default><![CDATA[]]></default>
|
1535 |
<type/>
|
1536 |
</argument>
|
1537 |
-
<argument line="
|
1538 |
<name>$value</name>
|
1539 |
<default><![CDATA[]]></default>
|
1540 |
<type/>
|
1541 |
</argument>
|
1542 |
</method>
|
1543 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1544 |
<name>mla_edit_tax_redirect</name>
|
1545 |
<full_name>mla_edit_tax_redirect</full_name>
|
1546 |
-
<docblock line="
|
1547 |
<description><![CDATA[Redirect to the Edit Tags/Categories page]]></description>
|
1548 |
<long-description><![CDATA[<p>The custom taxonomy add/edit submenu entries go to "upload.php" by default.
|
1549 |
This filter is the only way to redirect them to the correct WordPress page.</p>]]></long-description>
|
1550 |
-
<tag line="
|
1551 |
-
<tag line="
|
1552 |
<type by_reference="false">void</type>
|
1553 |
</tag>
|
1554 |
</docblock>
|
1555 |
</method>
|
1556 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1557 |
<name>mla_add_help_tab</name>
|
1558 |
<full_name>mla_add_help_tab</full_name>
|
1559 |
-
<docblock line="
|
1560 |
<description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
|
1561 |
<long-description><![CDATA[]]></long-description>
|
1562 |
-
<tag line="
|
1563 |
-
<tag line="
|
1564 |
<type by_reference="false">void</type>
|
1565 |
</tag>
|
1566 |
</docblock>
|
1567 |
</method>
|
1568 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1569 |
<name>mla_modify_parent_menu</name>
|
1570 |
<full_name>mla_modify_parent_menu</full_name>
|
1571 |
-
<docblock line="
|
1572 |
<description><![CDATA[Cleanup menus for Edit Tags/Categories page]]></description>
|
1573 |
<long-description><![CDATA[<p>The submenu entries for custom taxonomies under the "Media" menu are not set up
|
1574 |
correctly by WordPress, so this function cleans them up, redirecting the request
|
1575 |
to the right WordPress page for editing/adding taxonomy terms.</p>]]></long-description>
|
1576 |
-
<tag line="
|
1577 |
-
<tag line="
|
1578 |
<type by_reference="false">array</type>
|
1579 |
</tag>
|
1580 |
-
<tag line="
|
1581 |
<type by_reference="false">string</type>
|
1582 |
</tag>
|
1583 |
</docblock>
|
1584 |
-
<argument line="
|
1585 |
<name>$parent_file</name>
|
1586 |
<default><![CDATA[]]></default>
|
1587 |
<type/>
|
1588 |
</argument>
|
1589 |
</method>
|
1590 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1591 |
<name>mla_render_admin_page</name>
|
1592 |
<full_name>mla_render_admin_page</full_name>
|
1593 |
-
<docblock line="
|
1594 |
<description><![CDATA[Render the "Assistant" subpage in the Media section, using the list_table package]]></description>
|
1595 |
<long-description><![CDATA[]]></long-description>
|
1596 |
-
<tag line="
|
1597 |
-
<tag line="
|
1598 |
<type by_reference="false">void</type>
|
1599 |
</tag>
|
1600 |
</docblock>
|
1601 |
</method>
|
1602 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1603 |
<name>mla_inline_edit_action</name>
|
1604 |
<full_name>mla_inline_edit_action</full_name>
|
1605 |
-
<docblock line="
|
1606 |
<description><![CDATA[Ajax handler for inline editing (quick and bulk edit)]]></description>
|
1607 |
<long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
|
1608 |
-
<tag line="
|
1609 |
-
<tag line="
|
1610 |
<type by_reference="false">void</type>
|
1611 |
</tag>
|
1612 |
</docblock>
|
1613 |
</method>
|
1614 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1615 |
<name>_build_inline_edit_form</name>
|
1616 |
<full_name>_build_inline_edit_form</full_name>
|
1617 |
-
<docblock line="
|
1618 |
<description><![CDATA[Build the hidden row templates for inline editing (quick and bulk edit)]]></description>
|
1619 |
<long-description><![CDATA[<p>inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.</p>]]></long-description>
|
1620 |
-
<tag line="
|
1621 |
-
<tag line="
|
1622 |
<type by_reference="false">object</type>
|
1623 |
</tag>
|
1624 |
-
<tag line="
|
1625 |
<type by_reference="false">string</type>
|
1626 |
</tag>
|
1627 |
</docblock>
|
1628 |
-
<argument line="
|
1629 |
<name>$MLAListTable</name>
|
1630 |
<default><![CDATA[]]></default>
|
1631 |
<type/>
|
1632 |
</argument>
|
1633 |
</method>
|
1634 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1635 |
<name>_authors_dropdown</name>
|
1636 |
<full_name>_authors_dropdown</full_name>
|
1637 |
-
<docblock line="
|
1638 |
<description><![CDATA[Get the edit Authors dropdown box, if user has suitable permissions]]></description>
|
1639 |
<long-description><![CDATA[]]></long-description>
|
1640 |
-
<tag line="
|
1641 |
-
<tag line="
|
1642 |
<type by_reference="false">integer</type>
|
1643 |
</tag>
|
1644 |
-
<tag line="
|
1645 |
<type by_reference="false">string</type>
|
1646 |
</tag>
|
1647 |
-
<tag line="
|
1648 |
<type by_reference="false">string</type>
|
1649 |
</tag>
|
1650 |
-
<tag line="
|
1651 |
<type by_reference="false">string</type>
|
1652 |
<type by_reference="false">false</type>
|
1653 |
</tag>
|
1654 |
</docblock>
|
1655 |
-
<argument line="
|
1656 |
<name>$author</name>
|
1657 |
<default><![CDATA[0]]></default>
|
1658 |
<type/>
|
1659 |
</argument>
|
1660 |
-
<argument line="
|
1661 |
<name>$name</name>
|
1662 |
<default><![CDATA['post_author']]></default>
|
1663 |
<type/>
|
1664 |
</argument>
|
1665 |
-
<argument line="
|
1666 |
<name>$class</name>
|
1667 |
<default><![CDATA['authors']]></default>
|
1668 |
<type/>
|
1669 |
</argument>
|
1670 |
</method>
|
1671 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1672 |
<name>_current_bulk_action</name>
|
1673 |
<full_name>_current_bulk_action</full_name>
|
1674 |
-
<docblock line="
|
1675 |
<description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
|
1676 |
<long-description><![CDATA[]]></long-description>
|
1677 |
-
<tag line="
|
1678 |
-
<tag line="
|
1679 |
<type by_reference="false">string</type>
|
1680 |
<type by_reference="false">false</type>
|
1681 |
</tag>
|
1682 |
</docblock>
|
1683 |
</method>
|
1684 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1685 |
<name>_delete_single_item</name>
|
1686 |
<full_name>_delete_single_item</full_name>
|
1687 |
-
<docblock line="
|
1688 |
<description><![CDATA[Delete a single item permanently]]></description>
|
1689 |
<long-description><![CDATA[]]></long-description>
|
1690 |
-
<tag line="
|
1691 |
-
<tag line="
|
1692 |
<type by_reference="false">array</type>
|
1693 |
</tag>
|
1694 |
-
<tag line="
|
1695 |
<type by_reference="false">array</type>
|
1696 |
</tag>
|
1697 |
</docblock>
|
1698 |
-
<argument line="
|
1699 |
<name>$post_id</name>
|
1700 |
<default><![CDATA[]]></default>
|
1701 |
<type/>
|
1702 |
</argument>
|
1703 |
</method>
|
1704 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1705 |
<name>_display_single_item</name>
|
1706 |
<full_name>_display_single_item</full_name>
|
1707 |
-
<docblock line="
|
1708 |
<description><![CDATA[Display a single item sub page; prepare the form to
|
1709 |
change the meta data for a single attachment.]]></description>
|
1710 |
<long-description><![CDATA[]]></long-description>
|
1711 |
-
<tag line="
|
1712 |
-
<tag line="
|
1713 |
<type by_reference="false">int</type>
|
1714 |
</tag>
|
1715 |
-
<tag line="
|
1716 |
<type by_reference="false">array</type>
|
1717 |
</tag>
|
1718 |
</docblock>
|
1719 |
-
<argument line="
|
1720 |
<name>$post_id</name>
|
1721 |
<default><![CDATA[]]></default>
|
1722 |
<type/>
|
1723 |
</argument>
|
1724 |
</method>
|
1725 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1726 |
<name>_update_single_item</name>
|
1727 |
<full_name>_update_single_item</full_name>
|
1728 |
-
<docblock line="
|
1729 |
<description><![CDATA[Update a single item; change the meta data
|
1730 |
for a single attachment.]]></description>
|
1731 |
<long-description><![CDATA[]]></long-description>
|
1732 |
-
<tag line="
|
1733 |
-
<tag line="
|
1734 |
<type by_reference="false">int</type>
|
1735 |
</tag>
|
1736 |
-
<tag line="
|
1737 |
<type by_reference="false">array</type>
|
1738 |
</tag>
|
1739 |
-
<tag line="
|
1740 |
<type by_reference="false">array</type>
|
1741 |
</tag>
|
1742 |
-
<tag line="
|
1743 |
<type by_reference="false">array</type>
|
1744 |
</tag>
|
1745 |
-
<tag line="
|
1746 |
<type by_reference="false">array</type>
|
1747 |
</tag>
|
1748 |
</docblock>
|
1749 |
-
<argument line="
|
1750 |
<name>$post_id</name>
|
1751 |
<default><![CDATA[]]></default>
|
1752 |
<type/>
|
1753 |
</argument>
|
1754 |
-
<argument line="
|
1755 |
<name>$new_data</name>
|
1756 |
<default><![CDATA[]]></default>
|
1757 |
<type/>
|
1758 |
</argument>
|
1759 |
-
<argument line="
|
1760 |
<name>$tax_input</name>
|
1761 |
<default><![CDATA[NULL]]></default>
|
1762 |
<type/>
|
1763 |
</argument>
|
1764 |
-
<argument line="
|
1765 |
<name>$tax_actions</name>
|
1766 |
<default><![CDATA[NULL]]></default>
|
1767 |
<type/>
|
1768 |
</argument>
|
1769 |
</method>
|
1770 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1771 |
<name>_remove_tags</name>
|
1772 |
<full_name>_remove_tags</full_name>
|
1773 |
-
<docblock line="
|
1774 |
<description><![CDATA[Remove tags from a term ids list]]></description>
|
1775 |
<long-description><![CDATA[]]></long-description>
|
1776 |
-
<tag line="
|
1777 |
-
<tag line="
|
1778 |
<type by_reference="false">array</type>
|
1779 |
</tag>
|
1780 |
-
<tag line="
|
1781 |
<type by_reference="false">array</type>
|
1782 |
</tag>
|
1783 |
-
<tag line="
|
1784 |
<type by_reference="false">object</type>
|
1785 |
</tag>
|
1786 |
-
<tag line="
|
1787 |
<type by_reference="false">array</type>
|
1788 |
</tag>
|
1789 |
</docblock>
|
1790 |
-
<argument line="
|
1791 |
<name>$terms_before</name>
|
1792 |
<default><![CDATA[]]></default>
|
1793 |
<type/>
|
1794 |
</argument>
|
1795 |
-
<argument line="
|
1796 |
<name>$tags</name>
|
1797 |
<default><![CDATA[]]></default>
|
1798 |
<type/>
|
1799 |
</argument>
|
1800 |
-
<argument line="
|
1801 |
<name>$taxonomy_obj</name>
|
1802 |
<default><![CDATA[]]></default>
|
1803 |
<type/>
|
1804 |
</argument>
|
1805 |
</method>
|
1806 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1807 |
<name>_restore_single_item</name>
|
1808 |
<full_name>_restore_single_item</full_name>
|
1809 |
-
<docblock line="
|
1810 |
<description><![CDATA[Restore a single item from the Trash]]></description>
|
1811 |
<long-description><![CDATA[]]></long-description>
|
1812 |
-
<tag line="
|
1813 |
-
<tag line="
|
1814 |
<type by_reference="false">array</type>
|
1815 |
</tag>
|
1816 |
-
<tag line="
|
1817 |
<type by_reference="false">array</type>
|
1818 |
</tag>
|
1819 |
</docblock>
|
1820 |
-
<argument line="
|
1821 |
<name>$post_id</name>
|
1822 |
<default><![CDATA[]]></default>
|
1823 |
<type/>
|
1824 |
</argument>
|
1825 |
</method>
|
1826 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
1827 |
<name>_trash_single_item</name>
|
1828 |
<full_name>_trash_single_item</full_name>
|
1829 |
-
<docblock line="
|
1830 |
<description><![CDATA[Move a single item to Trash]]></description>
|
1831 |
<long-description><![CDATA[]]></long-description>
|
1832 |
-
<tag line="
|
1833 |
-
<tag line="
|
1834 |
<type by_reference="false">array</type>
|
1835 |
</tag>
|
1836 |
-
<tag line="
|
1837 |
<type by_reference="false">array</type>
|
1838 |
</tag>
|
1839 |
</docblock>
|
1840 |
-
<argument line="
|
1841 |
<name>$post_id</name>
|
1842 |
<default><![CDATA[]]></default>
|
1843 |
<type/>
|
@@ -1845,7 +1853,7 @@ for a single attachment.]]></description>
|
|
1845 |
</method>
|
1846 |
</class>
|
1847 |
</file>
|
1848 |
-
<file path="includes\class-mla-objects.php" hash="
|
1849 |
<docblock line="2">
|
1850 |
<description><![CDATA[Media Library Assistant Custom Taxonomy and Post Type objects]]></description>
|
1851 |
<long-description><![CDATA[]]></long-description>
|
@@ -1886,59 +1894,59 @@ for a single attachment.]]></description>
|
|
1886 |
</tag>
|
1887 |
</docblock>
|
1888 |
</method>
|
1889 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1890 |
<name>mla_taxonomy_get_columns_filter</name>
|
1891 |
<full_name>mla_taxonomy_get_columns_filter</full_name>
|
1892 |
-
<docblock line="
|
1893 |
<description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
|
1894 |
which replaces the "Posts" column with an equivalent "Attachments" column.]]></description>
|
1895 |
<long-description><![CDATA[]]></long-description>
|
1896 |
-
<tag line="
|
1897 |
-
<tag line="
|
1898 |
<type by_reference="false">array</type>
|
1899 |
</tag>
|
1900 |
-
<tag line="
|
1901 |
<type by_reference="false">array</type>
|
1902 |
</tag>
|
1903 |
</docblock>
|
1904 |
-
<argument line="
|
1905 |
<name>$columns</name>
|
1906 |
<default><![CDATA[]]></default>
|
1907 |
<type/>
|
1908 |
</argument>
|
1909 |
</method>
|
1910 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
1911 |
<name>mla_taxonomy_column_filter</name>
|
1912 |
<full_name>mla_taxonomy_column_filter</full_name>
|
1913 |
-
<docblock line="
|
1914 |
<description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
|
1915 |
which returns a count of the attachments assigned a given term]]></description>
|
1916 |
<long-description><![CDATA[]]></long-description>
|
1917 |
-
<tag line="
|
1918 |
-
<tag line="
|
1919 |
<type by_reference="false">string</type>
|
1920 |
</tag>
|
1921 |
-
<tag line="
|
1922 |
<type by_reference="false">array</type>
|
1923 |
</tag>
|
1924 |
-
<tag line="
|
1925 |
<type by_reference="false">array</type>
|
1926 |
</tag>
|
1927 |
-
<tag line="
|
1928 |
<type by_reference="false">array</type>
|
1929 |
</tag>
|
1930 |
</docblock>
|
1931 |
-
<argument line="
|
1932 |
<name>$place_holder</name>
|
1933 |
<default><![CDATA[]]></default>
|
1934 |
<type/>
|
1935 |
</argument>
|
1936 |
-
<argument line="
|
1937 |
<name>$column_name</name>
|
1938 |
<default><![CDATA[]]></default>
|
1939 |
<type/>
|
1940 |
</argument>
|
1941 |
-
<argument line="
|
1942 |
<name>$term_id</name>
|
1943 |
<default><![CDATA[]]></default>
|
1944 |
<type/>
|
@@ -1946,7 +1954,7 @@ which returns a count of the attachments assigned a given term]]></description>
|
|
1946 |
</method>
|
1947 |
</class>
|
1948 |
</file>
|
1949 |
-
<file path="includes\class-mla-settings.php" hash="
|
1950 |
<docblock line="2">
|
1951 |
<description><![CDATA[Manages the plugin option settings and provides the settings page to edit them]]></description>
|
1952 |
<long-description><![CDATA[]]></long-description>
|
@@ -2043,272 +2051,285 @@ reset => reset function for 'custom' options; returns nothing. Usage:
|
|
2043 |
</tag>
|
2044 |
</docblock>
|
2045 |
</method>
|
2046 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
2047 |
<name>_version_upgrade</name>
|
2048 |
<full_name>_version_upgrade</full_name>
|
2049 |
-
<docblock line="
|
2050 |
<description><![CDATA[Database and option update check, for installing new versions]]></description>
|
2051 |
<long-description><![CDATA[]]></long-description>
|
2052 |
-
<tag line="
|
2053 |
-
<tag line="
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2054 |
<type by_reference="false">void</type>
|
2055 |
</tag>
|
2056 |
</docblock>
|
2057 |
</method>
|
2058 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2059 |
<name>mla_activation_hook</name>
|
2060 |
<full_name>mla_activation_hook</full_name>
|
2061 |
-
<docblock line="
|
2062 |
<description><![CDATA[Perform one-time actions on plugin activation]]></description>
|
2063 |
<long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
|
2064 |
-
<tag line="
|
2065 |
-
<tag line="
|
2066 |
<type by_reference="false">void</type>
|
2067 |
</tag>
|
2068 |
</docblock>
|
2069 |
</method>
|
2070 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2071 |
<name>mla_deactivation_hook</name>
|
2072 |
<full_name>mla_deactivation_hook</full_name>
|
2073 |
-
<docblock line="
|
2074 |
<description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
|
2075 |
<long-description><![CDATA[<p>Removes a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
|
2076 |
-
<tag line="
|
2077 |
-
<tag line="
|
2078 |
<type by_reference="false">void</type>
|
2079 |
</tag>
|
2080 |
</docblock>
|
2081 |
</method>
|
2082 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2083 |
<name>mla_admin_menu_action</name>
|
2084 |
<full_name>mla_admin_menu_action</full_name>
|
2085 |
-
<docblock line="
|
2086 |
<description><![CDATA[Add settings page in the "Settings" section,
|
2087 |
add settings link in the Plugins section entry for MLA.]]></description>
|
2088 |
<long-description><![CDATA[]]></long-description>
|
2089 |
-
<tag line="
|
2090 |
-
<tag line="
|
2091 |
<type by_reference="false">void</type>
|
2092 |
</tag>
|
2093 |
</docblock>
|
2094 |
</method>
|
2095 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2096 |
<name>mla_add_plugin_settings_link</name>
|
2097 |
<full_name>mla_add_plugin_settings_link</full_name>
|
2098 |
-
<docblock line="
|
2099 |
<description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
|
2100 |
<long-description><![CDATA[]]></long-description>
|
2101 |
-
<tag line="
|
2102 |
-
<tag line="
|
2103 |
<type by_reference="false">array</type>
|
2104 |
</tag>
|
2105 |
-
<tag line="
|
2106 |
<type by_reference="false">string</type>
|
2107 |
</tag>
|
2108 |
-
<tag line="
|
2109 |
<type by_reference="false">array</type>
|
2110 |
</tag>
|
2111 |
</docblock>
|
2112 |
-
<argument line="
|
2113 |
<name>$links</name>
|
2114 |
<default><![CDATA[]]></default>
|
2115 |
<type/>
|
2116 |
</argument>
|
2117 |
-
<argument line="
|
2118 |
<name>$file</name>
|
2119 |
<default><![CDATA[]]></default>
|
2120 |
<type/>
|
2121 |
</argument>
|
2122 |
</method>
|
2123 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2124 |
<name>mla_get_option</name>
|
2125 |
<full_name>mla_get_option</full_name>
|
2126 |
-
<docblock line="
|
2127 |
<description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
|
2128 |
<long-description><![CDATA[]]></long-description>
|
2129 |
-
<tag line="
|
2130 |
-
<tag line="
|
2131 |
<type by_reference="false">string</type>
|
2132 |
</tag>
|
2133 |
-
<tag line="
|
2134 |
<type by_reference="false">mixed</type>
|
2135 |
</tag>
|
2136 |
</docblock>
|
2137 |
-
<argument line="
|
2138 |
<name>$option</name>
|
2139 |
<default><![CDATA[]]></default>
|
2140 |
<type/>
|
2141 |
</argument>
|
2142 |
</method>
|
2143 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2144 |
<name>mla_update_option</name>
|
2145 |
<full_name>mla_update_option</full_name>
|
2146 |
-
<docblock line="
|
2147 |
<description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
|
2148 |
<long-description><![CDATA[]]></long-description>
|
2149 |
-
<tag line="
|
2150 |
-
<tag line="
|
2151 |
<type by_reference="false">string</type>
|
2152 |
</tag>
|
2153 |
-
<tag line="
|
2154 |
<type by_reference="false">mixed</type>
|
2155 |
</tag>
|
2156 |
-
<tag line="
|
2157 |
<type by_reference="false">boolean</type>
|
2158 |
</tag>
|
2159 |
</docblock>
|
2160 |
-
<argument line="
|
2161 |
<name>$option</name>
|
2162 |
<default><![CDATA[]]></default>
|
2163 |
<type/>
|
2164 |
</argument>
|
2165 |
-
<argument line="
|
2166 |
<name>$newvalue</name>
|
2167 |
<default><![CDATA[]]></default>
|
2168 |
<type/>
|
2169 |
</argument>
|
2170 |
</method>
|
2171 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2172 |
<name>mla_delete_option</name>
|
2173 |
<full_name>mla_delete_option</full_name>
|
2174 |
-
<docblock line="
|
2175 |
<description><![CDATA[Delete the stored value of a defined MLA option]]></description>
|
2176 |
<long-description><![CDATA[]]></long-description>
|
2177 |
-
<tag line="
|
2178 |
-
<tag line="
|
2179 |
<type by_reference="false">string</type>
|
2180 |
</tag>
|
2181 |
-
<tag line="
|
2182 |
<type by_reference="false">boolean</type>
|
2183 |
</tag>
|
2184 |
</docblock>
|
2185 |
-
<argument line="
|
2186 |
<name>$option</name>
|
2187 |
<default><![CDATA[]]></default>
|
2188 |
<type/>
|
2189 |
</argument>
|
2190 |
</method>
|
2191 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2192 |
<name>mla_render_settings_page</name>
|
2193 |
<full_name>mla_render_settings_page</full_name>
|
2194 |
-
<docblock line="
|
2195 |
<description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
|
2196 |
<long-description><![CDATA[]]></long-description>
|
2197 |
-
<tag line="
|
2198 |
-
<tag line="
|
2199 |
<type by_reference="false">void</type>
|
2200 |
</tag>
|
2201 |
</docblock>
|
2202 |
</method>
|
2203 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2204 |
<name>mla_taxonomy_support</name>
|
2205 |
<full_name>mla_taxonomy_support</full_name>
|
2206 |
-
<docblock line="
|
2207 |
<description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
|
2208 |
settings are being updated or reset.]]></description>
|
2209 |
<long-description><![CDATA[]]></long-description>
|
2210 |
-
<tag line="
|
2211 |
-
<tag line="
|
2212 |
<type by_reference="false">string</type>
|
2213 |
</tag>
|
2214 |
-
<tag line="
|
2215 |
<type by_reference="false">string</type>
|
2216 |
</tag>
|
2217 |
-
<tag line="
|
2218 |
<type by_reference="false">boolean</type>
|
2219 |
<type by_reference="false">string</type>
|
2220 |
</tag>
|
2221 |
</docblock>
|
2222 |
-
<argument line="
|
2223 |
<name>$tax_name</name>
|
2224 |
<default><![CDATA[]]></default>
|
2225 |
<type/>
|
2226 |
</argument>
|
2227 |
-
<argument line="
|
2228 |
<name>$support_type</name>
|
2229 |
<default><![CDATA['support']]></default>
|
2230 |
<type/>
|
2231 |
</argument>
|
2232 |
</method>
|
2233 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
2234 |
<name>_save_settings</name>
|
2235 |
<full_name>_save_settings</full_name>
|
2236 |
-
<docblock line="
|
2237 |
<description><![CDATA[Save settings to the options table]]></description>
|
2238 |
<long-description><![CDATA[]]></long-description>
|
2239 |
-
<tag line="
|
2240 |
-
<tag line="
|
2241 |
<type by_reference="false">array</type>
|
2242 |
</tag>
|
2243 |
-
<tag line="
|
2244 |
<type by_reference="false">array</type>
|
2245 |
</tag>
|
2246 |
</docblock>
|
2247 |
-
<argument line="
|
2248 |
<name>$template_array</name>
|
2249 |
<default><![CDATA[]]></default>
|
2250 |
<type/>
|
2251 |
</argument>
|
2252 |
</method>
|
2253 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
2254 |
<name>_reset_settings</name>
|
2255 |
<full_name>_reset_settings</full_name>
|
2256 |
-
<docblock line="
|
2257 |
<description><![CDATA[Delete saved settings, restoring default values]]></description>
|
2258 |
<long-description><![CDATA[]]></long-description>
|
2259 |
-
<tag line="
|
2260 |
-
<tag line="
|
2261 |
<type by_reference="false">array</type>
|
2262 |
</tag>
|
2263 |
-
<tag line="
|
2264 |
<type by_reference="false">array</type>
|
2265 |
</tag>
|
2266 |
</docblock>
|
2267 |
-
<argument line="
|
2268 |
<name>$template_array</name>
|
2269 |
<default><![CDATA[]]></default>
|
2270 |
<type/>
|
2271 |
</argument>
|
2272 |
</method>
|
2273 |
-
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="
|
2274 |
<name>_taxonomy_handler</name>
|
2275 |
<full_name>_taxonomy_handler</full_name>
|
2276 |
-
<docblock line="
|
2277 |
<description><![CDATA[Render and manage other taxonomy support options, e.g., Categories and Post Tags]]></description>
|
2278 |
<long-description><![CDATA[]]></long-description>
|
2279 |
-
<tag line="
|
2280 |
-
<tag line="
|
2281 |
<type by_reference="false">string</type>
|
2282 |
</tag>
|
2283 |
-
<tag line="
|
2284 |
<type by_reference="false">string</type>
|
2285 |
</tag>
|
2286 |
-
<tag line="
|
2287 |
<type by_reference="false">array</type>
|
2288 |
</tag>
|
2289 |
-
<tag line="
|
2290 |
<type by_reference="false">array</type>
|
2291 |
</tag>
|
2292 |
-
<tag line="
|
2293 |
<type by_reference="false">string</type>
|
2294 |
</tag>
|
2295 |
</docblock>
|
2296 |
-
<argument line="
|
2297 |
<name>$action</name>
|
2298 |
<default><![CDATA[]]></default>
|
2299 |
<type/>
|
2300 |
</argument>
|
2301 |
-
<argument line="
|
2302 |
<name>$key</name>
|
2303 |
<default><![CDATA[]]></default>
|
2304 |
<type/>
|
2305 |
</argument>
|
2306 |
-
<argument line="
|
2307 |
<name>$value</name>
|
2308 |
<default><![CDATA[]]></default>
|
2309 |
<type/>
|
2310 |
</argument>
|
2311 |
-
<argument line="
|
2312 |
<name>$args</name>
|
2313 |
<default><![CDATA[]]></default>
|
2314 |
<type/>
|
@@ -2316,7 +2337,7 @@ settings are being updated or reset.]]></description>
|
|
2316 |
</method>
|
2317 |
</class>
|
2318 |
</file>
|
2319 |
-
<file path="includes\class-mla-shortcodes.php" hash="
|
2320 |
<docblock line="2">
|
2321 |
<description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
|
2322 |
<long-description><![CDATA[]]></long-description>
|
@@ -2345,18 +2366,60 @@ settings are being updated or reset.]]></description>
|
|
2345 |
</tag>
|
2346 |
</docblock>
|
2347 |
</method>
|
2348 |
-
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="
|
2349 |
<name>mla_attachment_list_shortcode</name>
|
2350 |
<full_name>mla_attachment_list_shortcode</full_name>
|
2351 |
-
<docblock line="
|
2352 |
<description><![CDATA[WordPress Shortcode; renders a complete list of all attachments and references to them]]></description>
|
2353 |
<long-description><![CDATA[]]></long-description>
|
2354 |
-
<tag line="
|
2355 |
-
<tag line="
|
2356 |
<type by_reference="false">void</type>
|
2357 |
</tag>
|
2358 |
</docblock>
|
2359 |
</method>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2360 |
</class>
|
2361 |
</file>
|
2362 |
<file path="includes\mla-plugin-loader.php" hash="9abec375c6f7ae5efd70d593750132ef" package="Media Library Assistant">
|
@@ -2398,13 +2461,13 @@ This file is only loaded if the naming conflict tests in index.php are passed.</
|
|
2398 |
</docblock>
|
2399 |
</constant>
|
2400 |
</file>
|
2401 |
-
<file path="index.php" hash="
|
2402 |
<docblock line="2">
|
2403 |
<description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
|
2404 |
<long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
|
2405 |
will the rest of the plugin be loaded and run.</p>]]></long-description>
|
2406 |
<tag line="2" name="package" description="Media Library Assistant"/>
|
2407 |
-
<tag line="2" name="version" description="0.
|
2408 |
</docblock>
|
2409 |
<include line="103" type="Require Once" package="Media Library Assistant">
|
2410 |
<name>includes/mla-plugin-loader.php</name>
|
1 |
<?xml version="1.0" encoding="utf-8"?>
|
2 |
<project version="2.0.0a8" title="Media Library Assistant">
|
3 |
+
<file path="includes\class-mla-data.php" hash="a7a7cf84277084dd2745f90fa38c39c7" package="Media Library Assistant">
|
4 |
<docblock line="2">
|
5 |
<description><![CDATA[Database and template file access for MLA needs]]></description>
|
6 |
<long-description><![CDATA[]]></long-description>
|
18 |
<tag line="9" name="package" description="Media Library Assistant"/>
|
19 |
<tag line="9" name="since" description="0.1"/>
|
20 |
</docblock>
|
21 |
+
<property final="false" static="true" visibility="private" line="222" namespace="global" package="Media Library Assistant">
|
22 |
<name>$query_parameters</name>
|
23 |
<default><![CDATA[array()]]></default>
|
24 |
+
<docblock line="211">
|
25 |
<description><![CDATA[WP_Query filter "parameters"]]></description>
|
26 |
<long-description><![CDATA[<p>This array defines parameters for the query's join, where and orderby filters.
|
27 |
The parameters are set up in the _prepare_list_table_query function, and
|
28 |
any further logic required to translate those values is contained in the filters.</p>]]></long-description>
|
29 |
+
<tag line="211" name="since" description="0.30"/>
|
30 |
+
<tag line="211" name="var" description="" type="array">
|
31 |
<type by_reference="false">array</type>
|
32 |
</tag>
|
33 |
</docblock>
|
41 |
<tag line="19" name="since" description="0.1"/>
|
42 |
</docblock>
|
43 |
</method>
|
44 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="46" package="Media Library Assistant">
|
45 |
<name>mla_load_template</name>
|
46 |
<full_name>mla_load_template</full_name>
|
47 |
<docblock line="28">
|
50 |
Multi-part templates are divided by comments of the form <!-- template="key" -->,
|
51 |
where "key" becomes the key part of the array.</p>]]></long-description>
|
52 |
<tag line="28" name="since" description="0.1"/>
|
53 |
+
<tag line="28" name="param" description="Complete path and name of the template file, option name or the raw template" type="string" variable="$source">
|
54 |
<type by_reference="false">string</type>
|
55 |
</tag>
|
56 |
+
<tag line="28" name="param" description="Type of template source; 'file', 'option', 'string'" type="string" variable="$type">
|
57 |
+
<type by_reference="false">string</type>
|
58 |
+
</tag>
|
59 |
+
<tag line="28" name="return" description="string for files that do not contain template divider comments, array for files containing template divider comments, false if file or option does not exist, NULL if file could not be loaded." type="string|array|false|NULL">
|
60 |
<type by_reference="false">string</type>
|
61 |
<type by_reference="false">array</type>
|
62 |
<type by_reference="false">false</type>
|
63 |
<type by_reference="false">NULL</type>
|
64 |
</tag>
|
65 |
</docblock>
|
66 |
+
<argument line="46">
|
67 |
+
<name>$source</name>
|
68 |
<default><![CDATA[]]></default>
|
69 |
<type/>
|
70 |
</argument>
|
71 |
+
<argument line="46">
|
72 |
+
<name>$type</name>
|
73 |
+
<default><![CDATA['file']]></default>
|
74 |
+
<type/>
|
75 |
+
</argument>
|
76 |
</method>
|
77 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="141" package="Media Library Assistant">
|
78 |
<name>mla_parse_template</name>
|
79 |
<full_name>mla_parse_template</full_name>
|
80 |
+
<docblock line="129">
|
81 |
<description><![CDATA[Expand a template, replacing place holders with their values]]></description>
|
82 |
<long-description><![CDATA[<p>A simple parsing function for basic templating.</p>]]></long-description>
|
83 |
+
<tag line="129" name="since" description="0.1"/>
|
84 |
+
<tag line="129" name="param" description="A formatting string containing [+placeholders+]" type="string" variable="$tpl">
|
85 |
<type by_reference="false">string</type>
|
86 |
</tag>
|
87 |
+
<tag line="129" name="param" description="An associative array containing keys and values e.g. array('key' => 'value')" type="array" variable="$hash">
|
88 |
<type by_reference="false">array</type>
|
89 |
</tag>
|
90 |
+
<tag line="129" name="return" description="Placeholders corresponding to the keys of the hash will be replaced with their values" type="string">
|
91 |
<type by_reference="false">string</type>
|
92 |
</tag>
|
93 |
</docblock>
|
94 |
+
<argument line="141">
|
95 |
<name>$tpl</name>
|
96 |
<default><![CDATA[]]></default>
|
97 |
<type/>
|
98 |
</argument>
|
99 |
+
<argument line="141">
|
100 |
<name>$hash</name>
|
101 |
<default><![CDATA[]]></default>
|
102 |
<type/>
|
103 |
</argument>
|
104 |
</method>
|
105 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="159" package="Media Library Assistant">
|
106 |
<name>mla_count_list_table_items</name>
|
107 |
<full_name>mla_count_list_table_items</full_name>
|
108 |
+
<docblock line="150">
|
109 |
<description><![CDATA[Get the total number of attachment posts]]></description>
|
110 |
<long-description><![CDATA[]]></long-description>
|
111 |
+
<tag line="150" name="since" description="0.30"/>
|
112 |
+
<tag line="150" name="param" description="Query variables, e.g., from $_REQUEST" type="array" variable="$request">
|
113 |
<type by_reference="false">array</type>
|
114 |
</tag>
|
115 |
+
<tag line="150" name="return" description="Number of attachment posts" type="integer">
|
116 |
<type by_reference="false">integer</type>
|
117 |
</tag>
|
118 |
</docblock>
|
119 |
+
<argument line="159">
|
120 |
<name>$request</name>
|
121 |
<default><![CDATA[]]></default>
|
122 |
<type/>
|
123 |
</argument>
|
124 |
</method>
|
125 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="180" package="Media Library Assistant">
|
126 |
<name>mla_query_list_table_items</name>
|
127 |
<full_name>mla_query_list_table_items</full_name>
|
128 |
+
<docblock line="166">
|
129 |
<description><![CDATA[Retrieve attachment objects for list table display]]></description>
|
130 |
<long-description><![CDATA[<p>Supports prepare_items in class-mla-list-table.php.
|
131 |
Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
|
132 |
+
<tag line="166" name="since" description="0.1"/>
|
133 |
+
<tag line="166" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
|
134 |
<type by_reference="false">array</type>
|
135 |
</tag>
|
136 |
+
<tag line="166" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
|
137 |
<type by_reference="false">int</type>
|
138 |
</tag>
|
139 |
+
<tag line="166" name="param" description="number of rows on each page" type="int" variable="$count">
|
140 |
<type by_reference="false">int</type>
|
141 |
</tag>
|
142 |
+
<tag line="166" name="return" description="attachment objects (posts) including parent data, meta data and references" type="array">
|
143 |
<type by_reference="false">array</type>
|
144 |
</tag>
|
145 |
</docblock>
|
146 |
+
<argument line="180">
|
147 |
<name>$request</name>
|
148 |
<default><![CDATA[]]></default>
|
149 |
<type/>
|
150 |
</argument>
|
151 |
+
<argument line="180">
|
152 |
<name>$offset</name>
|
153 |
<default><![CDATA[]]></default>
|
154 |
<type/>
|
155 |
</argument>
|
156 |
+
<argument line="180">
|
157 |
<name>$count</name>
|
158 |
<default><![CDATA[]]></default>
|
159 |
<type/>
|
160 |
</argument>
|
161 |
</method>
|
162 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="238" package="Media Library Assistant">
|
163 |
<name>_prepare_list_table_query</name>
|
164 |
<full_name>_prepare_list_table_query</full_name>
|
165 |
+
<docblock line="224">
|
166 |
<description><![CDATA[Sanitize and expand query arguments from request variables]]></description>
|
167 |
<long-description><![CDATA[<p>Prepare the arguments for WP_Query.
|
168 |
Modeled after wp_edit_attachments_query in wp-admin/post.php</p>]]></long-description>
|
169 |
+
<tag line="224" name="since" description="0.1"/>
|
170 |
+
<tag line="224" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$raw_request">
|
171 |
<type by_reference="false">array</type>
|
172 |
</tag>
|
173 |
+
<tag line="224" name="param" description="number of rows to skip over to reach desired page" type="int" variable="$offset">
|
174 |
<type by_reference="false">int</type>
|
175 |
</tag>
|
176 |
+
<tag line="224" name="param" description="number of rows on each page (0 = all rows)" type="int" variable="$count">
|
177 |
<type by_reference="false">int</type>
|
178 |
</tag>
|
179 |
+
<tag line="224" name="return" description="revised arguments suitable for WP_Query" type="array">
|
180 |
<type by_reference="false">array</type>
|
181 |
</tag>
|
182 |
</docblock>
|
183 |
+
<argument line="238">
|
184 |
<name>$raw_request</name>
|
185 |
<default><![CDATA[]]></default>
|
186 |
<type/>
|
187 |
</argument>
|
188 |
+
<argument line="238">
|
189 |
<name>$offset</name>
|
190 |
<default><![CDATA[0]]></default>
|
191 |
<type/>
|
192 |
</argument>
|
193 |
+
<argument line="238">
|
194 |
<name>$count</name>
|
195 |
<default><![CDATA[0]]></default>
|
196 |
<type/>
|
197 |
</argument>
|
198 |
</method>
|
199 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="409" package="Media Library Assistant">
|
200 |
<name>_execute_list_table_query</name>
|
201 |
<full_name>_execute_list_table_query</full_name>
|
202 |
+
<docblock line="400">
|
203 |
<description><![CDATA[Add filters, run query, remove filters]]></description>
|
204 |
<long-description><![CDATA[]]></long-description>
|
205 |
+
<tag line="400" name="since" description="0.30"/>
|
206 |
+
<tag line="400" name="param" description="query parameters from web page, usually found in $_REQUEST" type="array" variable="$request">
|
207 |
<type by_reference="false">array</type>
|
208 |
</tag>
|
209 |
+
<tag line="400" name="return" description="WP_Query object with query results" type="object">
|
210 |
<type by_reference="false">object</type>
|
211 |
</tag>
|
212 |
</docblock>
|
213 |
+
<argument line="409">
|
214 |
<name>$request</name>
|
215 |
<default><![CDATA[]]></default>
|
216 |
<type/>
|
217 |
</argument>
|
218 |
</method>
|
219 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="434" package="Media Library Assistant">
|
220 |
<name>mla_query_posts_join_filter</name>
|
221 |
<full_name>mla_query_posts_join_filter</full_name>
|
222 |
+
<docblock line="423">
|
223 |
<description><![CDATA[Adds a JOIN clause, if required]]></description>
|
224 |
<long-description><![CDATA[<p>Defined as public because it's a filter.</p>]]></long-description>
|
225 |
+
<tag line="423" name="since" description="0.30"/>
|
226 |
+
<tag line="423" name="param" description="query clause before modification" type="string" variable="$join_clause">
|
227 |
<type by_reference="false">string</type>
|
228 |
</tag>
|
229 |
+
<tag line="423" name="return" description="query clause after "detached" item modification" type="string">
|
230 |
<type by_reference="false">string</type>
|
231 |
</tag>
|
232 |
</docblock>
|
233 |
+
<argument line="434">
|
234 |
<name>$join_clause</name>
|
235 |
<default><![CDATA[]]></default>
|
236 |
<type/>
|
237 |
</argument>
|
238 |
</method>
|
239 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="461" package="Media Library Assistant">
|
240 |
<name>mla_query_posts_where_filter</name>
|
241 |
<full_name>mla_query_posts_where_filter</full_name>
|
242 |
+
<docblock line="449">
|
243 |
<description><![CDATA[Adds a WHERE clause for detached items]]></description>
|
244 |
<long-description><![CDATA[<p>Modeled after _edit_attachments_query_helper in wp-admin/post.php.
|
245 |
Defined as public because it's a filter.</p>]]></long-description>
|
246 |
+
<tag line="449" name="since" description="0.1"/>
|
247 |
+
<tag line="449" name="param" description="query clause before modification" type="string" variable="$where_clause">
|
248 |
<type by_reference="false">string</type>
|
249 |
</tag>
|
250 |
+
<tag line="449" name="return" description="query clause after "detached" item modification" type="string">
|
251 |
<type by_reference="false">string</type>
|
252 |
</tag>
|
253 |
</docblock>
|
254 |
+
<argument line="461">
|
255 |
<name>$where_clause</name>
|
256 |
<default><![CDATA[]]></default>
|
257 |
<type/>
|
258 |
</argument>
|
259 |
</method>
|
260 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="482" package="Media Library Assistant">
|
261 |
<name>mla_query_posts_orderby_filter</name>
|
262 |
<full_name>mla_query_posts_orderby_filter</full_name>
|
263 |
+
<docblock line="470">
|
264 |
<description><![CDATA[Adds a ORDERBY clause, if required]]></description>
|
265 |
<long-description><![CDATA[<p>Expands the range of sort options because the logic in WP_Query is limited.
|
266 |
Defined as public because it's a filter.</p>]]></long-description>
|
267 |
+
<tag line="470" name="since" description="0.30"/>
|
268 |
+
<tag line="470" name="param" description="query clause before modification" type="string" variable="$orderby_clause">
|
269 |
<type by_reference="false">string</type>
|
270 |
</tag>
|
271 |
+
<tag line="470" name="return" description="updated query clause" type="string">
|
272 |
<type by_reference="false">string</type>
|
273 |
</tag>
|
274 |
</docblock>
|
275 |
+
<argument line="482">
|
276 |
<name>$orderby_clause</name>
|
277 |
<default><![CDATA[]]></default>
|
278 |
<type/>
|
279 |
</argument>
|
280 |
</method>
|
281 |
+
<method final="false" abstract="false" static="false" visibility="public" namespace="global" line="531" package="Media Library Assistant">
|
282 |
<name>mla_get_attachment_by_id</name>
|
283 |
<full_name>mla_get_attachment_by_id</full_name>
|
284 |
+
<docblock line="520">
|
285 |
<description><![CDATA[Retrieve an Attachment array given a $post_id]]></description>
|
286 |
<long-description><![CDATA[<p>The (associative) array will contain every field that can be found in
|
287 |
the posts and postmeta tables, and all references to the attachment.</p>]]></long-description>
|
288 |
+
<tag line="520" name="since" description="0.1"/>
|
289 |
+
<tag line="520" name="param" description="The ID of the attachment post" type="int" variable="$post_id">
|
290 |
<type by_reference="false">int</type>
|
291 |
</tag>
|
292 |
+
<tag line="520" name="return" description="NULL on failure else associative array" type="NULL|array">
|
293 |
<type by_reference="false">NULL</type>
|
294 |
<type by_reference="false">array</type>
|
295 |
</tag>
|
296 |
</docblock>
|
297 |
+
<argument line="531">
|
298 |
<name>$post_id</name>
|
299 |
<default><![CDATA[]]></default>
|
300 |
<type/>
|
301 |
</argument>
|
302 |
</method>
|
303 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="580" package="Media Library Assistant">
|
304 |
<name>mla_fetch_attachment_references</name>
|
305 |
<full_name>mla_fetch_attachment_references</full_name>
|
306 |
+
<docblock line="567">
|
307 |
<description><![CDATA[Find Featured Image and inserted image/link references to an attachment]]></description>
|
308 |
<long-description><![CDATA[<p>Searches all post and page content to see if the attachment is used
|
309 |
as a Featured Image or inserted in the post as an image or link.</p>]]></long-description>
|
310 |
+
<tag line="567" name="since" description="0.1"/>
|
311 |
+
<tag line="567" name="param" description="post ID of attachment" type="int" variable="$ID">
|
312 |
<type by_reference="false">int</type>
|
313 |
</tag>
|
314 |
+
<tag line="567" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent">
|
315 |
<type by_reference="false">int</type>
|
316 |
</tag>
|
317 |
+
<tag line="567" name="return" description="Reference information; see $references array comments" type="array">
|
318 |
<type by_reference="false">array</type>
|
319 |
</tag>
|
320 |
</docblock>
|
321 |
+
<argument line="580">
|
322 |
<name>$ID</name>
|
323 |
<default><![CDATA[]]></default>
|
324 |
<type/>
|
325 |
</argument>
|
326 |
+
<argument line="580">
|
327 |
<name>$parent</name>
|
328 |
<default><![CDATA[]]></default>
|
329 |
<type/>
|
330 |
</argument>
|
331 |
</method>
|
332 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="727" package="Media Library Assistant">
|
333 |
<name>_fetch_attachment_parent_data</name>
|
334 |
<full_name>_fetch_attachment_parent_data</full_name>
|
335 |
+
<docblock line="718">
|
336 |
<description><![CDATA[Returns information about an attachment's parent, if found]]></description>
|
337 |
<long-description><![CDATA[]]></long-description>
|
338 |
+
<tag line="718" name="since" description="0.1"/>
|
339 |
+
<tag line="718" name="param" description="post ID of attachment's parent, if any" type="int" variable="$parent_id">
|
340 |
<type by_reference="false">int</type>
|
341 |
</tag>
|
342 |
+
<tag line="718" name="return" description="Parent information; post_date, post_title and post_type" type="array">
|
343 |
<type by_reference="false">array</type>
|
344 |
</tag>
|
345 |
</docblock>
|
346 |
+
<argument line="727">
|
347 |
<name>$parent_id</name>
|
348 |
<default><![CDATA[]]></default>
|
349 |
<type/>
|
350 |
</argument>
|
351 |
</method>
|
352 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="755" package="Media Library Assistant">
|
353 |
<name>_fetch_attachment_metadata</name>
|
354 |
<full_name>_fetch_attachment_metadata</full_name>
|
355 |
+
<docblock line="742">
|
356 |
<description><![CDATA[Fetch and filter meta data for an attachment]]></description>
|
357 |
<long-description><![CDATA[<p>Returns a filtered array of a post's meta data. Internal values beginning with '<em>'
|
358 |
are stripped out or converted to an 'mla</em>' equivalent. Array data is replaced with
|
359 |
a string containing the first array element.</p>]]></long-description>
|
360 |
+
<tag line="742" name="since" description="0.1"/>
|
361 |
+
<tag line="742" name="param" description="post ID of attachment" type="int" variable="$post_id">
|
362 |
<type by_reference="false">int</type>
|
363 |
</tag>
|
364 |
+
<tag line="742" name="return" description="Meta data variables" type="array">
|
365 |
<type by_reference="false">array</type>
|
366 |
</tag>
|
367 |
</docblock>
|
368 |
+
<argument line="755">
|
369 |
<name>$post_id</name>
|
370 |
<default><![CDATA[]]></default>
|
371 |
<type/>
|
1170 |
</method>
|
1171 |
</class>
|
1172 |
</file>
|
1173 |
+
<file path="includes\class-mla-main.php" hash="2c8f9915bf1378a0a98232a27894e3a0" package="Media Library Assistant">
|
1174 |
<docblock line="2">
|
1175 |
<description><![CDATA[Top-level functions for the Media Library Assistant]]></description>
|
1176 |
<long-description><![CDATA[]]></long-description>
|
1207 |
<constant namespace="global" line="41" package="Media Library Assistant">
|
1208 |
<name>CURRENT_MLA_VERSION</name>
|
1209 |
<full_name>CURRENT_MLA_VERSION</full_name>
|
1210 |
+
<value><![CDATA['0.50']]></value>
|
1211 |
<docblock line="34">
|
1212 |
<description><![CDATA[Current version number]]></description>
|
1213 |
<long-description><![CDATA[]]></long-description>
|
1455 |
<type/>
|
1456 |
</argument>
|
1457 |
</method>
|
1458 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="263" package="Media Library Assistant">
|
1459 |
<name>mla_admin_menu_action</name>
|
1460 |
<full_name>mla_admin_menu_action</full_name>
|
1461 |
+
<docblock line="250">
|
1462 |
<description><![CDATA[Add the submenu pages]]></description>
|
1463 |
<long-description><![CDATA[<p>Add a submenu page in the "Media" section,
|
1464 |
add submenu page(s) for attachment taxonomies,
|
1465 |
add filter to clean up taxonomy submenu labels
|
1466 |
add settings page in the "Settings" section,
|
1467 |
add settings link in the Plugins section entry for MLA.</p>]]></long-description>
|
1468 |
+
<tag line="250" name="since" description="0.1"/>
|
1469 |
+
<tag line="250" name="return" description="" type="void">
|
1470 |
<type by_reference="false">void</type>
|
1471 |
</tag>
|
1472 |
</docblock>
|
1473 |
</method>
|
1474 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="294" package="Media Library Assistant">
|
1475 |
<name>mla_add_menu_options</name>
|
1476 |
<full_name>mla_add_menu_options</full_name>
|
1477 |
+
<docblock line="287">
|
1478 |
<description><![CDATA[Add the "XX Entries per page" filter to the Screen Options tab]]></description>
|
1479 |
<long-description><![CDATA[]]></long-description>
|
1480 |
+
<tag line="287" name="since" description="0.1"/>
|
1481 |
+
<tag line="287" name="return" description="" type="void">
|
1482 |
<type by_reference="false">void</type>
|
1483 |
</tag>
|
1484 |
</docblock>
|
1485 |
</method>
|
1486 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="316" package="Media Library Assistant">
|
1487 |
<name>mla_screen_options_show_screen_filter</name>
|
1488 |
<full_name>mla_screen_options_show_screen_filter</full_name>
|
1489 |
+
<docblock line="306">
|
1490 |
<description><![CDATA[Only show screen options on the table-list screen]]></description>
|
1491 |
<long-description><![CDATA[]]></long-description>
|
1492 |
+
<tag line="306" name="since" description="0.1"/>
|
1493 |
+
<tag line="306" name="param" description="True to display "Screen Options", false to suppress them" type="boolean" variable="$show_screen">
|
1494 |
<type by_reference="false">boolean</type>
|
1495 |
</tag>
|
1496 |
+
<tag line="306" name="param" description="Name of the page being loaded" type="string" variable="$this_screen">
|
1497 |
<type by_reference="false">string</type>
|
1498 |
</tag>
|
1499 |
+
<tag line="306" name="return" description="True to display "Screen Options", false to suppress them" type="boolean">
|
1500 |
<type by_reference="false">boolean</type>
|
1501 |
</tag>
|
1502 |
</docblock>
|
1503 |
+
<argument line="316">
|
1504 |
<name>$show_screen</name>
|
1505 |
<default><![CDATA[]]></default>
|
1506 |
<type/>
|
1507 |
</argument>
|
1508 |
+
<argument line="316">
|
1509 |
<name>$this_screen</name>
|
1510 |
<default><![CDATA[]]></default>
|
1511 |
<type/>
|
1512 |
</argument>
|
1513 |
</method>
|
1514 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="334" package="Media Library Assistant">
|
1515 |
<name>mla_set_screen_option_filter</name>
|
1516 |
<full_name>mla_set_screen_option_filter</full_name>
|
1517 |
+
<docblock line="323">
|
1518 |
<description><![CDATA[Save the "Entries per page" option set by this user]]></description>
|
1519 |
<long-description><![CDATA[]]></long-description>
|
1520 |
+
<tag line="323" name="since" description="0.1"/>
|
1521 |
+
<tag line="323" name="param" description="Unknown - always false?" type="boolean" variable="$status">
|
1522 |
<type by_reference="false">boolean</type>
|
1523 |
</tag>
|
1524 |
+
<tag line="323" name="param" description="Name of the option being changed" type="string" variable="$option">
|
1525 |
<type by_reference="false">string</type>
|
1526 |
</tag>
|
1527 |
+
<tag line="323" name="param" description="New value of the option" type="string" variable="$value">
|
1528 |
<type by_reference="false">string</type>
|
1529 |
</tag>
|
1530 |
+
<tag line="323" name="return" description="New value if this is our option, otherwise nothing" type="string|void">
|
1531 |
<type by_reference="false">string</type>
|
1532 |
<type by_reference="false">void</type>
|
1533 |
</tag>
|
1534 |
</docblock>
|
1535 |
+
<argument line="334">
|
1536 |
<name>$status</name>
|
1537 |
<default><![CDATA[]]></default>
|
1538 |
<type/>
|
1539 |
</argument>
|
1540 |
+
<argument line="334">
|
1541 |
<name>$option</name>
|
1542 |
<default><![CDATA[]]></default>
|
1543 |
<type/>
|
1544 |
</argument>
|
1545 |
+
<argument line="334">
|
1546 |
<name>$value</name>
|
1547 |
<default><![CDATA[]]></default>
|
1548 |
<type/>
|
1549 |
</argument>
|
1550 |
</method>
|
1551 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="350" package="Media Library Assistant">
|
1552 |
<name>mla_edit_tax_redirect</name>
|
1553 |
<full_name>mla_edit_tax_redirect</full_name>
|
1554 |
+
<docblock line="340">
|
1555 |
<description><![CDATA[Redirect to the Edit Tags/Categories page]]></description>
|
1556 |
<long-description><![CDATA[<p>The custom taxonomy add/edit submenu entries go to "upload.php" by default.
|
1557 |
This filter is the only way to redirect them to the correct WordPress page.</p>]]></long-description>
|
1558 |
+
<tag line="340" name="since" description="0.1"/>
|
1559 |
+
<tag line="340" name="return" description="" type="void">
|
1560 |
<type by_reference="false">void</type>
|
1561 |
</tag>
|
1562 |
</docblock>
|
1563 |
</method>
|
1564 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="368" package="Media Library Assistant">
|
1565 |
<name>mla_add_help_tab</name>
|
1566 |
<full_name>mla_add_help_tab</full_name>
|
1567 |
+
<docblock line="361">
|
1568 |
<description><![CDATA[Add contextual help tabs to all the MLA pages]]></description>
|
1569 |
<long-description><![CDATA[]]></long-description>
|
1570 |
+
<tag line="361" name="since" description="0.1"/>
|
1571 |
+
<tag line="361" name="return" description="" type="void">
|
1572 |
<type by_reference="false">void</type>
|
1573 |
</tag>
|
1574 |
</docblock>
|
1575 |
</method>
|
1576 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="460" package="Media Library Assistant">
|
1577 |
<name>mla_modify_parent_menu</name>
|
1578 |
<full_name>mla_modify_parent_menu</full_name>
|
1579 |
+
<docblock line="447">
|
1580 |
<description><![CDATA[Cleanup menus for Edit Tags/Categories page]]></description>
|
1581 |
<long-description><![CDATA[<p>The submenu entries for custom taxonomies under the "Media" menu are not set up
|
1582 |
correctly by WordPress, so this function cleans them up, redirecting the request
|
1583 |
to the right WordPress page for editing/adding taxonomy terms.</p>]]></long-description>
|
1584 |
+
<tag line="447" name="since" description="0.1"/>
|
1585 |
+
<tag line="447" name="param" description="The top-level menu page" type="array" variable="$parent_file">
|
1586 |
<type by_reference="false">array</type>
|
1587 |
</tag>
|
1588 |
+
<tag line="447" name="return" description="The updated top-level menu page" type="string">
|
1589 |
<type by_reference="false">string</type>
|
1590 |
</tag>
|
1591 |
</docblock>
|
1592 |
+
<argument line="460">
|
1593 |
<name>$parent_file</name>
|
1594 |
<default><![CDATA[]]></default>
|
1595 |
<type/>
|
1596 |
</argument>
|
1597 |
</method>
|
1598 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="491" package="Media Library Assistant">
|
1599 |
<name>mla_render_admin_page</name>
|
1600 |
<full_name>mla_render_admin_page</full_name>
|
1601 |
+
<docblock line="484">
|
1602 |
<description><![CDATA[Render the "Assistant" subpage in the Media section, using the list_table package]]></description>
|
1603 |
<long-description><![CDATA[]]></long-description>
|
1604 |
+
<tag line="484" name="since" description="0.1"/>
|
1605 |
+
<tag line="484" name="return" description="" type="void">
|
1606 |
<type by_reference="false">void</type>
|
1607 |
</tag>
|
1608 |
</docblock>
|
1609 |
</method>
|
1610 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="689" package="Media Library Assistant">
|
1611 |
<name>mla_inline_edit_action</name>
|
1612 |
<full_name>mla_inline_edit_action</full_name>
|
1613 |
+
<docblock line="680">
|
1614 |
<description><![CDATA[Ajax handler for inline editing (quick and bulk edit)]]></description>
|
1615 |
<long-description><![CDATA[<p>Adapted from wp_ajax_inline_save in /wp-admin/includes/ajax-actions.php</p>]]></long-description>
|
1616 |
+
<tag line="680" name="since" description="0.20"/>
|
1617 |
+
<tag line="680" name="return" description="echo HTML <tr> markup for updated row or error message, then die()" type="void">
|
1618 |
<type by_reference="false">void</type>
|
1619 |
</tag>
|
1620 |
</docblock>
|
1621 |
</method>
|
1622 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="758" package="Media Library Assistant">
|
1623 |
<name>_build_inline_edit_form</name>
|
1624 |
<full_name>_build_inline_edit_form</full_name>
|
1625 |
+
<docblock line="747">
|
1626 |
<description><![CDATA[Build the hidden row templates for inline editing (quick and bulk edit)]]></description>
|
1627 |
<long-description><![CDATA[<p>inspired by inline_edit() in wp-admin\includes\class-wp-posts-list-table.php.</p>]]></long-description>
|
1628 |
+
<tag line="747" name="since" description="0.20"/>
|
1629 |
+
<tag line="747" name="param" description="MLA List Table object" type="object" variable="$MLAListTable">
|
1630 |
<type by_reference="false">object</type>
|
1631 |
</tag>
|
1632 |
+
<tag line="747" name="return" description="HTML <form> markup for hidden rows" type="string">
|
1633 |
<type by_reference="false">string</type>
|
1634 |
</tag>
|
1635 |
</docblock>
|
1636 |
+
<argument line="758">
|
1637 |
<name>$MLAListTable</name>
|
1638 |
<default><![CDATA[]]></default>
|
1639 |
<type/>
|
1640 |
</argument>
|
1641 |
</method>
|
1642 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="885" package="Media Library Assistant">
|
1643 |
<name>_authors_dropdown</name>
|
1644 |
<full_name>_authors_dropdown</full_name>
|
1645 |
+
<docblock line="874">
|
1646 |
<description><![CDATA[Get the edit Authors dropdown box, if user has suitable permissions]]></description>
|
1647 |
<long-description><![CDATA[]]></long-description>
|
1648 |
+
<tag line="874" name="since" description="0.20"/>
|
1649 |
+
<tag line="874" name="param" description="User ID of the current author" type="integer" variable="$author">
|
1650 |
<type by_reference="false">integer</type>
|
1651 |
</tag>
|
1652 |
+
<tag line="874" name="param" description="HTML name attribute" type="string" variable="$name">
|
1653 |
<type by_reference="false">string</type>
|
1654 |
</tag>
|
1655 |
+
<tag line="874" name="param" description="HTML class attribute" type="string" variable="$class">
|
1656 |
<type by_reference="false">string</type>
|
1657 |
</tag>
|
1658 |
+
<tag line="874" name="return" description="HTML markup for the dropdown field or False" type="string|false">
|
1659 |
<type by_reference="false">string</type>
|
1660 |
<type by_reference="false">false</type>
|
1661 |
</tag>
|
1662 |
</docblock>
|
1663 |
+
<argument line="885">
|
1664 |
<name>$author</name>
|
1665 |
<default><![CDATA[0]]></default>
|
1666 |
<type/>
|
1667 |
</argument>
|
1668 |
+
<argument line="885">
|
1669 |
<name>$name</name>
|
1670 |
<default><![CDATA['post_author']]></default>
|
1671 |
<type/>
|
1672 |
</argument>
|
1673 |
+
<argument line="885">
|
1674 |
<name>$class</name>
|
1675 |
<default><![CDATA['authors']]></default>
|
1676 |
<type/>
|
1677 |
</argument>
|
1678 |
</method>
|
1679 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="917" package="Media Library Assistant">
|
1680 |
<name>_current_bulk_action</name>
|
1681 |
<full_name>_current_bulk_action</full_name>
|
1682 |
+
<docblock line="910">
|
1683 |
<description><![CDATA[Get the current action selected from the bulk actions dropdown]]></description>
|
1684 |
<long-description><![CDATA[]]></long-description>
|
1685 |
+
<tag line="910" name="since" description="0.1"/>
|
1686 |
+
<tag line="910" name="return" description="The action name or False if no action was selected" type="string|false">
|
1687 |
<type by_reference="false">string</type>
|
1688 |
<type by_reference="false">false</type>
|
1689 |
</tag>
|
1690 |
</docblock>
|
1691 |
</method>
|
1692 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="947" package="Media Library Assistant">
|
1693 |
<name>_delete_single_item</name>
|
1694 |
<full_name>_delete_single_item</full_name>
|
1695 |
+
<docblock line="938">
|
1696 |
<description><![CDATA[Delete a single item permanently]]></description>
|
1697 |
<long-description><![CDATA[]]></long-description>
|
1698 |
+
<tag line="938" name="since" description="0.1"/>
|
1699 |
+
<tag line="938" name="param" description="The form POST data" type="array" variable="$post_id">
|
1700 |
<type by_reference="false">array</type>
|
1701 |
</tag>
|
1702 |
+
<tag line="938" name="return" description="success/failure message and NULL content" type="array">
|
1703 |
<type by_reference="false">array</type>
|
1704 |
</tag>
|
1705 |
</docblock>
|
1706 |
+
<argument line="947">
|
1707 |
<name>$post_id</name>
|
1708 |
<default><![CDATA[]]></default>
|
1709 |
<type/>
|
1710 |
</argument>
|
1711 |
</method>
|
1712 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="976" package="Media Library Assistant">
|
1713 |
<name>_display_single_item</name>
|
1714 |
<full_name>_display_single_item</full_name>
|
1715 |
+
<docblock line="966">
|
1716 |
<description><![CDATA[Display a single item sub page; prepare the form to
|
1717 |
change the meta data for a single attachment.]]></description>
|
1718 |
<long-description><![CDATA[]]></long-description>
|
1719 |
+
<tag line="966" name="since" description="0.1"/>
|
1720 |
+
<tag line="966" name="param" description="The WordPress Post ID of the attachment item" type="int" variable="$post_id">
|
1721 |
<type by_reference="false">int</type>
|
1722 |
</tag>
|
1723 |
+
<tag line="966" name="return" description="message and/or HTML content" type="array">
|
1724 |
<type by_reference="false">array</type>
|
1725 |
</tag>
|
1726 |
</docblock>
|
1727 |
+
<argument line="976">
|
1728 |
<name>$post_id</name>
|
1729 |
<default><![CDATA[]]></default>
|
1730 |
<type/>
|
1731 |
</argument>
|
1732 |
</method>
|
1733 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1190" package="Media Library Assistant">
|
1734 |
<name>_update_single_item</name>
|
1735 |
<full_name>_update_single_item</full_name>
|
1736 |
+
<docblock line="1177">
|
1737 |
<description><![CDATA[Update a single item; change the meta data
|
1738 |
for a single attachment.]]></description>
|
1739 |
<long-description><![CDATA[]]></long-description>
|
1740 |
+
<tag line="1177" name="since" description="0.1"/>
|
1741 |
+
<tag line="1177" name="param" description="The ID of the attachment to be updated" type="int" variable="$post_id">
|
1742 |
<type by_reference="false">int</type>
|
1743 |
</tag>
|
1744 |
+
<tag line="1177" name="param" description="Field name => value pairs" type="array" variable="$new_data">
|
1745 |
<type by_reference="false">array</type>
|
1746 |
</tag>
|
1747 |
+
<tag line="1177" name="param" description="Taxonomy term values" type="array" variable="$tax_input">
|
1748 |
<type by_reference="false">array</type>
|
1749 |
</tag>
|
1750 |
+
<tag line="1177" name="param" description="Taxonomy actions (add, remove, replace)" type="array" variable="$tax_actions">
|
1751 |
<type by_reference="false">array</type>
|
1752 |
</tag>
|
1753 |
+
<tag line="1177" name="return" description="success/failure message and NULL content" type="array">
|
1754 |
<type by_reference="false">array</type>
|
1755 |
</tag>
|
1756 |
</docblock>
|
1757 |
+
<argument line="1190">
|
1758 |
<name>$post_id</name>
|
1759 |
<default><![CDATA[]]></default>
|
1760 |
<type/>
|
1761 |
</argument>
|
1762 |
+
<argument line="1190">
|
1763 |
<name>$new_data</name>
|
1764 |
<default><![CDATA[]]></default>
|
1765 |
<type/>
|
1766 |
</argument>
|
1767 |
+
<argument line="1190">
|
1768 |
<name>$tax_input</name>
|
1769 |
<default><![CDATA[NULL]]></default>
|
1770 |
<type/>
|
1771 |
</argument>
|
1772 |
+
<argument line="1190">
|
1773 |
<name>$tax_actions</name>
|
1774 |
<default><![CDATA[NULL]]></default>
|
1775 |
<type/>
|
1776 |
</argument>
|
1777 |
</method>
|
1778 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1373" package="Media Library Assistant">
|
1779 |
<name>_remove_tags</name>
|
1780 |
<full_name>_remove_tags</full_name>
|
1781 |
+
<docblock line="1362">
|
1782 |
<description><![CDATA[Remove tags from a term ids list]]></description>
|
1783 |
<long-description><![CDATA[]]></long-description>
|
1784 |
+
<tag line="1362" name="since" description="0.40"/>
|
1785 |
+
<tag line="1362" name="param" description="The term ids currently assigned" type="array" variable="$terms_before">
|
1786 |
<type by_reference="false">array</type>
|
1787 |
</tag>
|
1788 |
+
<tag line="1362" name="param" description="| string The term ids (array) or names (string) to remove" type="array" variable="$tags">
|
1789 |
<type by_reference="false">array</type>
|
1790 |
</tag>
|
1791 |
+
<tag line="1362" name="param" description="The taxonomy object" type="object" variable="$taxonomy_obj">
|
1792 |
<type by_reference="false">object</type>
|
1793 |
</tag>
|
1794 |
+
<tag line="1362" name="return" description="Term ids of the surviving tags" type="array">
|
1795 |
<type by_reference="false">array</type>
|
1796 |
</tag>
|
1797 |
</docblock>
|
1798 |
+
<argument line="1373">
|
1799 |
<name>$terms_before</name>
|
1800 |
<default><![CDATA[]]></default>
|
1801 |
<type/>
|
1802 |
</argument>
|
1803 |
+
<argument line="1373">
|
1804 |
<name>$tags</name>
|
1805 |
<default><![CDATA[]]></default>
|
1806 |
<type/>
|
1807 |
</argument>
|
1808 |
+
<argument line="1373">
|
1809 |
<name>$taxonomy_obj</name>
|
1810 |
<default><![CDATA[]]></default>
|
1811 |
<type/>
|
1812 |
</argument>
|
1813 |
</method>
|
1814 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1415" package="Media Library Assistant">
|
1815 |
<name>_restore_single_item</name>
|
1816 |
<full_name>_restore_single_item</full_name>
|
1817 |
+
<docblock line="1406">
|
1818 |
<description><![CDATA[Restore a single item from the Trash]]></description>
|
1819 |
<long-description><![CDATA[]]></long-description>
|
1820 |
+
<tag line="1406" name="since" description="0.1"/>
|
1821 |
+
<tag line="1406" name="param" description="The form POST data" type="array" variable="$post_id">
|
1822 |
<type by_reference="false">array</type>
|
1823 |
</tag>
|
1824 |
+
<tag line="1406" name="return" description="success/failure message and NULL content" type="array">
|
1825 |
<type by_reference="false">array</type>
|
1826 |
</tag>
|
1827 |
</docblock>
|
1828 |
+
<argument line="1415">
|
1829 |
<name>$post_id</name>
|
1830 |
<default><![CDATA[]]></default>
|
1831 |
<type/>
|
1832 |
</argument>
|
1833 |
</method>
|
1834 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="1451" package="Media Library Assistant">
|
1835 |
<name>_trash_single_item</name>
|
1836 |
<full_name>_trash_single_item</full_name>
|
1837 |
+
<docblock line="1442">
|
1838 |
<description><![CDATA[Move a single item to Trash]]></description>
|
1839 |
<long-description><![CDATA[]]></long-description>
|
1840 |
+
<tag line="1442" name="since" description="0.1"/>
|
1841 |
+
<tag line="1442" name="param" description="The form POST data" type="array" variable="$post_id">
|
1842 |
<type by_reference="false">array</type>
|
1843 |
</tag>
|
1844 |
+
<tag line="1442" name="return" description="success/failure message and NULL content" type="array">
|
1845 |
<type by_reference="false">array</type>
|
1846 |
</tag>
|
1847 |
</docblock>
|
1848 |
+
<argument line="1451">
|
1849 |
<name>$post_id</name>
|
1850 |
<default><![CDATA[]]></default>
|
1851 |
<type/>
|
1853 |
</method>
|
1854 |
</class>
|
1855 |
</file>
|
1856 |
+
<file path="includes\class-mla-objects.php" hash="365a8f71e063969bed4a81d103c220a6" package="Media Library Assistant">
|
1857 |
<docblock line="2">
|
1858 |
<description><![CDATA[Media Library Assistant Custom Taxonomy and Post Type objects]]></description>
|
1859 |
<long-description><![CDATA[]]></long-description>
|
1894 |
</tag>
|
1895 |
</docblock>
|
1896 |
</method>
|
1897 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="114" package="Media Library Assistant">
|
1898 |
<name>mla_taxonomy_get_columns_filter</name>
|
1899 |
<full_name>mla_taxonomy_get_columns_filter</full_name>
|
1900 |
+
<docblock line="104">
|
1901 |
<description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
|
1902 |
which replaces the "Posts" column with an equivalent "Attachments" column.]]></description>
|
1903 |
<long-description><![CDATA[]]></long-description>
|
1904 |
+
<tag line="104" name="since" description="0.30"/>
|
1905 |
+
<tag line="104" name="param" description="column definitions for the edit taxonomy list table" type="array" variable="$columns">
|
1906 |
<type by_reference="false">array</type>
|
1907 |
</tag>
|
1908 |
+
<tag line="104" name="return" description="updated column definitions for the edit taxonomy list table" type="array">
|
1909 |
<type by_reference="false">array</type>
|
1910 |
</tag>
|
1911 |
</docblock>
|
1912 |
+
<argument line="114">
|
1913 |
<name>$columns</name>
|
1914 |
<default><![CDATA[]]></default>
|
1915 |
<type/>
|
1916 |
</argument>
|
1917 |
</method>
|
1918 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="140" package="Media Library Assistant">
|
1919 |
<name>mla_taxonomy_column_filter</name>
|
1920 |
<full_name>mla_taxonomy_column_filter</full_name>
|
1921 |
+
<docblock line="127">
|
1922 |
<description><![CDATA[WordPress Filter for edit taxonomy "Attachments" column,
|
1923 |
which returns a count of the attachments assigned a given term]]></description>
|
1924 |
<long-description><![CDATA[]]></long-description>
|
1925 |
+
<tag line="127" name="since" description="0.30"/>
|
1926 |
+
<tag line="127" name="param" description="current column value; always ''" type="string" variable="$place_holder">
|
1927 |
<type by_reference="false">string</type>
|
1928 |
</tag>
|
1929 |
+
<tag line="127" name="param" description="name of the column" type="array" variable="$column_name">
|
1930 |
<type by_reference="false">array</type>
|
1931 |
</tag>
|
1932 |
+
<tag line="127" name="param" description="ID of the term for which the count is desired" type="array" variable="$term_id">
|
1933 |
<type by_reference="false">array</type>
|
1934 |
</tag>
|
1935 |
+
<tag line="127" name="return" description="HTML markup for the column content; number of attachments in the category and alink to retrieve a list of them" type="array">
|
1936 |
<type by_reference="false">array</type>
|
1937 |
</tag>
|
1938 |
</docblock>
|
1939 |
+
<argument line="140">
|
1940 |
<name>$place_holder</name>
|
1941 |
<default><![CDATA[]]></default>
|
1942 |
<type/>
|
1943 |
</argument>
|
1944 |
+
<argument line="140">
|
1945 |
<name>$column_name</name>
|
1946 |
<default><![CDATA[]]></default>
|
1947 |
<type/>
|
1948 |
</argument>
|
1949 |
+
<argument line="140">
|
1950 |
<name>$term_id</name>
|
1951 |
<default><![CDATA[]]></default>
|
1952 |
<type/>
|
1954 |
</method>
|
1955 |
</class>
|
1956 |
</file>
|
1957 |
+
<file path="includes\class-mla-settings.php" hash="0b5952919548fa0a7e29ad41d0f03940" package="Media Library Assistant">
|
1958 |
<docblock line="2">
|
1959 |
<description><![CDATA[Manages the plugin option settings and provides the settings page to edit them]]></description>
|
1960 |
<long-description><![CDATA[]]></long-description>
|
2051 |
</tag>
|
2052 |
</docblock>
|
2053 |
</method>
|
2054 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="187" package="Media Library Assistant">
|
2055 |
<name>_version_upgrade</name>
|
2056 |
<full_name>_version_upgrade</full_name>
|
2057 |
+
<docblock line="180">
|
2058 |
<description><![CDATA[Database and option update check, for installing new versions]]></description>
|
2059 |
<long-description><![CDATA[]]></long-description>
|
2060 |
+
<tag line="180" name="since" description="0.30"/>
|
2061 |
+
<tag line="180" name="return" description="" type="void">
|
2062 |
+
<type by_reference="false">void</type>
|
2063 |
+
</tag>
|
2064 |
+
</docblock>
|
2065 |
+
</method>
|
2066 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="229" package="Media Library Assistant">
|
2067 |
+
<name>_create_alt_text_view</name>
|
2068 |
+
<full_name>_create_alt_text_view</full_name>
|
2069 |
+
<docblock line="219">
|
2070 |
+
<description><![CDATA[Add a view to the database to support sorting the listing on 'ALT Text']]></description>
|
2071 |
+
<long-description><![CDATA[<p>This function is called on each plugin invocation because the plugin upgrade process
|
2072 |
+
does not call the activation hook.</p>]]></long-description>
|
2073 |
+
<tag line="219" name="since" description="0.50"/>
|
2074 |
+
<tag line="219" name="return" description="" type="void">
|
2075 |
<type by_reference="false">void</type>
|
2076 |
</tag>
|
2077 |
</docblock>
|
2078 |
</method>
|
2079 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="265" package="Media Library Assistant">
|
2080 |
<name>mla_activation_hook</name>
|
2081 |
<full_name>mla_activation_hook</full_name>
|
2082 |
+
<docblock line="256">
|
2083 |
<description><![CDATA[Perform one-time actions on plugin activation]]></description>
|
2084 |
<long-description><![CDATA[<p>Adds a view to the database to support sorting the listing on 'ALT Text'.</p>]]></long-description>
|
2085 |
+
<tag line="256" name="since" description="0.40"/>
|
2086 |
+
<tag line="256" name="return" description="" type="void">
|
2087 |
<type by_reference="false">void</type>
|
2088 |
</tag>
|
2089 |
</docblock>
|
2090 |
</method>
|
2091 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="278" package="Media Library Assistant">
|
2092 |
<name>mla_deactivation_hook</name>
|
2093 |
<full_name>mla_deactivation_hook</full_name>
|
2094 |
+
<docblock line="269">
|
2095 |
<description><![CDATA[Perform one-time actions on plugin deactivation]]></description>
|
2096 |
<long-description><![CDATA[<p>Removes a view from the database that supports sorting the listing on 'ALT Text'.</p>]]></long-description>
|
2097 |
+
<tag line="269" name="since" description="0.40"/>
|
2098 |
+
<tag line="269" name="return" description="" type="void">
|
2099 |
<type by_reference="false">void</type>
|
2100 |
</tag>
|
2101 |
</docblock>
|
2102 |
</method>
|
2103 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="309" package="Media Library Assistant">
|
2104 |
<name>mla_admin_menu_action</name>
|
2105 |
<full_name>mla_admin_menu_action</full_name>
|
2106 |
+
<docblock line="301">
|
2107 |
<description><![CDATA[Add settings page in the "Settings" section,
|
2108 |
add settings link in the Plugins section entry for MLA.]]></description>
|
2109 |
<long-description><![CDATA[]]></long-description>
|
2110 |
+
<tag line="301" name="since" description="0.1"/>
|
2111 |
+
<tag line="301" name="return" description="" type="void">
|
2112 |
<type by_reference="false">void</type>
|
2113 |
</tag>
|
2114 |
</docblock>
|
2115 |
</method>
|
2116 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="327" package="Media Library Assistant">
|
2117 |
<name>mla_add_plugin_settings_link</name>
|
2118 |
<full_name>mla_add_plugin_settings_link</full_name>
|
2119 |
+
<docblock line="317">
|
2120 |
<description><![CDATA[Add the "Settings" link to the MLA entry in the Plugins section]]></description>
|
2121 |
<long-description><![CDATA[]]></long-description>
|
2122 |
+
<tag line="317" name="since" description="0.1"/>
|
2123 |
+
<tag line="317" name="param" description="array of links for the Plugin, e.g., "Activate"" type="array" variable="$links">
|
2124 |
<type by_reference="false">array</type>
|
2125 |
</tag>
|
2126 |
+
<tag line="317" name="param" description="Directory and name of the plugin Index file" type="string" variable="$file">
|
2127 |
<type by_reference="false">string</type>
|
2128 |
</tag>
|
2129 |
+
<tag line="317" name="return" description="Updated array of links for the Plugin" type="array">
|
2130 |
<type by_reference="false">array</type>
|
2131 |
</tag>
|
2132 |
</docblock>
|
2133 |
+
<argument line="327">
|
2134 |
<name>$links</name>
|
2135 |
<default><![CDATA[]]></default>
|
2136 |
<type/>
|
2137 |
</argument>
|
2138 |
+
<argument line="327">
|
2139 |
<name>$file</name>
|
2140 |
<default><![CDATA[]]></default>
|
2141 |
<type/>
|
2142 |
</argument>
|
2143 |
</method>
|
2144 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="345" package="Media Library Assistant">
|
2145 |
<name>mla_get_option</name>
|
2146 |
<full_name>mla_get_option</full_name>
|
2147 |
+
<docblock line="336">
|
2148 |
<description><![CDATA[Return the stored value or default value of a defined MLA option]]></description>
|
2149 |
<long-description><![CDATA[]]></long-description>
|
2150 |
+
<tag line="336" name="since" description="0.1"/>
|
2151 |
+
<tag line="336" name="param" description="Name of the desired option" type="string" variable="$option">
|
2152 |
<type by_reference="false">string</type>
|
2153 |
</tag>
|
2154 |
+
<tag line="336" name="return" description="Value(s) for the option or false if the option is not a defined MLA option" type="mixed">
|
2155 |
<type by_reference="false">mixed</type>
|
2156 |
</tag>
|
2157 |
</docblock>
|
2158 |
+
<argument line="345">
|
2159 |
<name>$option</name>
|
2160 |
<default><![CDATA[]]></default>
|
2161 |
<type/>
|
2162 |
</argument>
|
2163 |
</method>
|
2164 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="366" package="Media Library Assistant">
|
2165 |
<name>mla_update_option</name>
|
2166 |
<full_name>mla_update_option</full_name>
|
2167 |
+
<docblock line="356">
|
2168 |
<description><![CDATA[Add or update the stored value of a defined MLA option]]></description>
|
2169 |
<long-description><![CDATA[]]></long-description>
|
2170 |
+
<tag line="356" name="since" description="0.1"/>
|
2171 |
+
<tag line="356" name="param" description="Name of the desired option" type="string" variable="$option">
|
2172 |
<type by_reference="false">string</type>
|
2173 |
</tag>
|
2174 |
+
<tag line="356" name="param" description="New value for the desired option" type="mixed" variable="$newvalue">
|
2175 |
<type by_reference="false">mixed</type>
|
2176 |
</tag>
|
2177 |
+
<tag line="356" name="return" description="True if the value was changed or false if the update failed" type="boolean">
|
2178 |
<type by_reference="false">boolean</type>
|
2179 |
</tag>
|
2180 |
</docblock>
|
2181 |
+
<argument line="366">
|
2182 |
<name>$option</name>
|
2183 |
<default><![CDATA[]]></default>
|
2184 |
<type/>
|
2185 |
</argument>
|
2186 |
+
<argument line="366">
|
2187 |
<name>$newvalue</name>
|
2188 |
<default><![CDATA[]]></default>
|
2189 |
<type/>
|
2190 |
</argument>
|
2191 |
</method>
|
2192 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="382" package="Media Library Assistant">
|
2193 |
<name>mla_delete_option</name>
|
2194 |
<full_name>mla_delete_option</full_name>
|
2195 |
+
<docblock line="373">
|
2196 |
<description><![CDATA[Delete the stored value of a defined MLA option]]></description>
|
2197 |
<long-description><![CDATA[]]></long-description>
|
2198 |
+
<tag line="373" name="since" description="0.1"/>
|
2199 |
+
<tag line="373" name="param" description="Name of the desired option" type="string" variable="$option">
|
2200 |
<type by_reference="false">string</type>
|
2201 |
</tag>
|
2202 |
+
<tag line="373" name="return" description="True if the option was deleted, otherwise false" type="boolean">
|
2203 |
<type by_reference="false">boolean</type>
|
2204 |
</tag>
|
2205 |
</docblock>
|
2206 |
+
<argument line="382">
|
2207 |
<name>$option</name>
|
2208 |
<default><![CDATA[]]></default>
|
2209 |
<type/>
|
2210 |
</argument>
|
2211 |
</method>
|
2212 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="397" package="Media Library Assistant">
|
2213 |
<name>mla_render_settings_page</name>
|
2214 |
<full_name>mla_render_settings_page</full_name>
|
2215 |
+
<docblock line="390">
|
2216 |
<description><![CDATA[Render (echo) the "Media Library Assistant" subpage in the Settings section]]></description>
|
2217 |
<long-description><![CDATA[]]></long-description>
|
2218 |
+
<tag line="390" name="since" description="0.1"/>
|
2219 |
+
<tag line="390" name="return" description="Echoes HTML markup for the settings subpage" type="void">
|
2220 |
<type by_reference="false">void</type>
|
2221 |
</tag>
|
2222 |
</docblock>
|
2223 |
</method>
|
2224 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="619" package="Media Library Assistant">
|
2225 |
<name>mla_taxonomy_support</name>
|
2226 |
<full_name>mla_taxonomy_support</full_name>
|
2227 |
+
<docblock line="606">
|
2228 |
<description><![CDATA[Determine MLA support for a taxonomy, handling the special case where the
|
2229 |
settings are being updated or reset.]]></description>
|
2230 |
<long-description><![CDATA[]]></long-description>
|
2231 |
+
<tag line="606" name="since" description="0.30"/>
|
2232 |
+
<tag line="606" name="param" description="Taxonomy name, e.g., attachment_category" type="string" variable="$tax_name">
|
2233 |
<type by_reference="false">string</type>
|
2234 |
</tag>
|
2235 |
+
<tag line="606" name="param" description="'support' (the default), 'quick-edit' or 'filter'" type="string" variable="$support_type">
|
2236 |
<type by_reference="false">string</type>
|
2237 |
</tag>
|
2238 |
+
<tag line="606" name="return" description="true if the taxonomy is supported in this way else false string if $tax_name is '' and $support_type is 'filter', returns the taxonomy to filter by" type="boolean|string">
|
2239 |
<type by_reference="false">boolean</type>
|
2240 |
<type by_reference="false">string</type>
|
2241 |
</tag>
|
2242 |
</docblock>
|
2243 |
+
<argument line="619">
|
2244 |
<name>$tax_name</name>
|
2245 |
<default><![CDATA[]]></default>
|
2246 |
<type/>
|
2247 |
</argument>
|
2248 |
+
<argument line="619">
|
2249 |
<name>$support_type</name>
|
2250 |
<default><![CDATA['support']]></default>
|
2251 |
<type/>
|
2252 |
</argument>
|
2253 |
</method>
|
2254 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="691" package="Media Library Assistant">
|
2255 |
<name>_save_settings</name>
|
2256 |
<full_name>_save_settings</full_name>
|
2257 |
+
<docblock line="682">
|
2258 |
<description><![CDATA[Save settings to the options table]]></description>
|
2259 |
<long-description><![CDATA[]]></long-description>
|
2260 |
+
<tag line="682" name="since" description="0.1"/>
|
2261 |
+
<tag line="682" name="param" description="HTML template(s) for the settings page" type="array" variable="$template_array">
|
2262 |
<type by_reference="false">array</type>
|
2263 |
</tag>
|
2264 |
+
<tag line="682" name="return" description="Message(s) reflecting the results of the operation" type="array">
|
2265 |
<type by_reference="false">array</type>
|
2266 |
</tag>
|
2267 |
</docblock>
|
2268 |
+
<argument line="691">
|
2269 |
<name>$template_array</name>
|
2270 |
<default><![CDATA[]]></default>
|
2271 |
<type/>
|
2272 |
</argument>
|
2273 |
</method>
|
2274 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="782" package="Media Library Assistant">
|
2275 |
<name>_reset_settings</name>
|
2276 |
<full_name>_reset_settings</full_name>
|
2277 |
+
<docblock line="773">
|
2278 |
<description><![CDATA[Delete saved settings, restoring default values]]></description>
|
2279 |
<long-description><![CDATA[]]></long-description>
|
2280 |
+
<tag line="773" name="since" description="0.1"/>
|
2281 |
+
<tag line="773" name="param" description="HTML template(s) for the settings page" type="array" variable="$template_array">
|
2282 |
<type by_reference="false">array</type>
|
2283 |
</tag>
|
2284 |
+
<tag line="773" name="return" description="Message(s) reflecting the results of the operation" type="array">
|
2285 |
<type by_reference="false">array</type>
|
2286 |
</tag>
|
2287 |
</docblock>
|
2288 |
+
<argument line="782">
|
2289 |
<name>$template_array</name>
|
2290 |
<default><![CDATA[]]></default>
|
2291 |
<type/>
|
2292 |
</argument>
|
2293 |
</method>
|
2294 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="825" package="Media Library Assistant">
|
2295 |
<name>_taxonomy_handler</name>
|
2296 |
<full_name>_taxonomy_handler</full_name>
|
2297 |
+
<docblock line="813">
|
2298 |
<description><![CDATA[Render and manage other taxonomy support options, e.g., Categories and Post Tags]]></description>
|
2299 |
<long-description><![CDATA[]]></long-description>
|
2300 |
+
<tag line="813" name="since" description="0.30"/>
|
2301 |
+
<tag line="813" name="param" description="'render', 'update', 'delete', or 'reset'" type="string" variable="$action">
|
2302 |
<type by_reference="false">string</type>
|
2303 |
</tag>
|
2304 |
+
<tag line="813" name="param" description="option name, e.g., 'taxonomy_support'" type="string" variable="$key">
|
2305 |
<type by_reference="false">string</type>
|
2306 |
</tag>
|
2307 |
+
<tag line="813" name="param" description="option parameters" type="array" variable="$value">
|
2308 |
<type by_reference="false">array</type>
|
2309 |
</tag>
|
2310 |
+
<tag line="813" name="param" description="The $page_template_array for 'render' else $_REQUEST" type="array" variable="$args">
|
2311 |
<type by_reference="false">array</type>
|
2312 |
</tag>
|
2313 |
+
<tag line="813" name="return" description="HTML table row markup for 'render' else message(s) reflecting the results of the operation." type="string">
|
2314 |
<type by_reference="false">string</type>
|
2315 |
</tag>
|
2316 |
</docblock>
|
2317 |
+
<argument line="825">
|
2318 |
<name>$action</name>
|
2319 |
<default><![CDATA[]]></default>
|
2320 |
<type/>
|
2321 |
</argument>
|
2322 |
+
<argument line="825">
|
2323 |
<name>$key</name>
|
2324 |
<default><![CDATA[]]></default>
|
2325 |
<type/>
|
2326 |
</argument>
|
2327 |
+
<argument line="825">
|
2328 |
<name>$value</name>
|
2329 |
<default><![CDATA[]]></default>
|
2330 |
<type/>
|
2331 |
</argument>
|
2332 |
+
<argument line="825">
|
2333 |
<name>$args</name>
|
2334 |
<default><![CDATA[]]></default>
|
2335 |
<type/>
|
2337 |
</method>
|
2338 |
</class>
|
2339 |
</file>
|
2340 |
+
<file path="includes\class-mla-shortcodes.php" hash="81880022f36a38665a25af8fc6e0734a" package="Media Library Assistant">
|
2341 |
<docblock line="2">
|
2342 |
<description><![CDATA[Media Library Assistant Shortcode handler(s)]]></description>
|
2343 |
<long-description><![CDATA[]]></long-description>
|
2366 |
</tag>
|
2367 |
</docblock>
|
2368 |
</method>
|
2369 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="35" package="Media Library Assistant">
|
2370 |
<name>mla_attachment_list_shortcode</name>
|
2371 |
<full_name>mla_attachment_list_shortcode</full_name>
|
2372 |
+
<docblock line="28">
|
2373 |
<description><![CDATA[WordPress Shortcode; renders a complete list of all attachments and references to them]]></description>
|
2374 |
<long-description><![CDATA[]]></long-description>
|
2375 |
+
<tag line="28" name="since" description="0.1"/>
|
2376 |
+
<tag line="28" name="return" description="echoes HTML markup for the attachment list" type="void">
|
2377 |
<type by_reference="false">void</type>
|
2378 |
</tag>
|
2379 |
</docblock>
|
2380 |
</method>
|
2381 |
+
<method final="false" abstract="false" static="true" visibility="public" namespace="global" line="138" package="Media Library Assistant">
|
2382 |
+
<name>mla_gallery_shortcode</name>
|
2383 |
+
<full_name>mla_gallery_shortcode</full_name>
|
2384 |
+
<docblock line="125">
|
2385 |
+
<description><![CDATA[The MLA Gallery shortcode.]]></description>
|
2386 |
+
<long-description><![CDATA[<p>This is a superset of the WordPress Gallery shortcode for displaying images on a post,
|
2387 |
+
page or custom post type. It is adapted from /wp-includes/media.php gallery_shortcode.
|
2388 |
+
Enhancements include many additional selection parameters and full taxonomy support.</p>]]></long-description>
|
2389 |
+
<tag line="125" name="since" description=".50"/>
|
2390 |
+
<tag line="125" name="param" description="Attributes of the shortcode." type="array" variable="$attr">
|
2391 |
+
<type by_reference="false">array</type>
|
2392 |
+
</tag>
|
2393 |
+
<tag line="125" name="return" description="HTML content to display gallery." type="string">
|
2394 |
+
<type by_reference="false">string</type>
|
2395 |
+
</tag>
|
2396 |
+
</docblock>
|
2397 |
+
<argument line="138">
|
2398 |
+
<name>$attr</name>
|
2399 |
+
<default><![CDATA[]]></default>
|
2400 |
+
<type/>
|
2401 |
+
</argument>
|
2402 |
+
</method>
|
2403 |
+
<method final="false" abstract="false" static="true" visibility="private" namespace="global" line="514" package="Media Library Assistant">
|
2404 |
+
<name>_get_attachments</name>
|
2405 |
+
<full_name>_get_attachments</full_name>
|
2406 |
+
<docblock line="505">
|
2407 |
+
<description><![CDATA[Replaces /wp-includes/post.php function get_posts()]]></description>
|
2408 |
+
<long-description><![CDATA[]]></long-description>
|
2409 |
+
<tag line="505" name="since" description=".50"/>
|
2410 |
+
<tag line="505" name="param" description="Attributes of the shortcode" type="array" variable="$args">
|
2411 |
+
<type by_reference="false">array</type>
|
2412 |
+
</tag>
|
2413 |
+
<tag line="505" name="return" description="List of attachments returned from WP_Query" type="array">
|
2414 |
+
<type by_reference="false">array</type>
|
2415 |
+
</tag>
|
2416 |
+
</docblock>
|
2417 |
+
<argument line="514">
|
2418 |
+
<name>$args</name>
|
2419 |
+
<default><![CDATA[]]></default>
|
2420 |
+
<type/>
|
2421 |
+
</argument>
|
2422 |
+
</method>
|
2423 |
</class>
|
2424 |
</file>
|
2425 |
<file path="includes\mla-plugin-loader.php" hash="9abec375c6f7ae5efd70d593750132ef" package="Media Library Assistant">
|
2461 |
</docblock>
|
2462 |
</constant>
|
2463 |
</file>
|
2464 |
+
<file path="index.php" hash="30c4fdc78cd5d1ecc4d04cd0212f3b9f" package="Media Library Assistant">
|
2465 |
<docblock line="2">
|
2466 |
<description><![CDATA[Provides several enhancements to the handling of images and files held in the WordPress Media Library]]></description>
|
2467 |
<long-description><![CDATA[<p>This file contains several tests for name conflicts with other plugins. Only if the tests are passed
|
2468 |
will the rest of the plugin be loaded and run.</p>]]></long-description>
|
2469 |
<tag line="2" name="package" description="Media Library Assistant"/>
|
2470 |
+
<tag line="2" name="version" description="0.50"/>
|
2471 |
</docblock>
|
2472 |
<include line="103" type="Require Once" package="Media Library Assistant">
|
2473 |
<name>includes/mla-plugin-loader.php</name>
|
readme.txt
CHANGED
@@ -4,17 +4,18 @@ Donate link: http://fairtradejudaica.org/make-a-difference/donate/
|
|
4 |
Tags: attachments, documents, gallery, image, images, media, library, media library, media-tags, media tags, tags, media categories, categories
|
5 |
Requires at least: 3.3
|
6 |
Tested up to: 3.4.2
|
7 |
-
Stable tag: 0.
|
8 |
License: GPLv2 or later
|
9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
10 |
|
11 |
-
Provides
|
12 |
-
such as full taxonomy support, bulk & quick edit actions and where-used reporting.
|
13 |
|
14 |
== Description ==
|
15 |
|
16 |
The Media Library Assistant provides several enhancements for managing the Media Library, including:
|
17 |
|
|
|
|
|
18 |
* An inline "Bulk Edit" area; update author or parent, add, remove or replace taxonomy terms for several attachments at once.
|
19 |
* An inline "Quick Edit" action for many common fields.
|
20 |
* Complete support for ALL taxonomies, including the standard Categories and Tags, your custom taxonomies and the Assistant's pre-defined Att. Categories and Att. Tags. You can add taxonomy columns to the Assistant listing, filter on any taxonomy, assign terms and list the attachments for a term.
|
@@ -25,9 +26,9 @@ The Media Library Assistant provides several enhancements for managing the Media
|
|
25 |
* Provides additional view filters for mime types and taxonomies
|
26 |
* Provides many more listing columns (more than 15) to choose from
|
27 |
|
28 |
-
The Assistant is designed to work like the standard Media Library pages, so the learning curve is short and gentle. Contextual help is provided on every new screen to highlight new features.
|
29 |
|
30 |
-
This plugin was inspired by my work on the WordPress web site for our nonprofit, Fair Trade Judaica. If you find the Media Library Assistant plugin useful and would like to support a great cause, consider a <strong>tax-deductible</strong> donation to our work. Thank you!
|
31 |
|
32 |
== Installation ==
|
33 |
|
@@ -37,9 +38,22 @@ This plugin was inspired by my work on the WordPress web site for our nonprofit,
|
|
37 |
1. Visit the "Assistant" submenu in the Media admin section
|
38 |
1. Click the Screen Options link to customize the display
|
39 |
1. Use the enhanced Edit page to assign categories and tags
|
|
|
40 |
|
41 |
== Frequently Asked Questions ==
|
42 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
43 |
= Can the Assistant use the standard WordPress post Categories and Tags? =
|
44 |
|
45 |
Yes! You can activate or deactivate support for Categories and Tags at any time by visiting the Media Library Assistant Settings page.
|
@@ -83,8 +97,13 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
|
|
83 |
|
84 |
== Changelog ==
|
85 |
|
|
|
|
|
|
|
|
|
|
|
86 |
= 0.41 =
|
87 |
-
* Fix: SQL View now created for automatic plugin upgrades
|
88 |
|
89 |
= 0.40 =
|
90 |
* New: Bulk Edit area; update author or parent, add, remove or replace taxonomy terms for several attachments at once
|
@@ -127,6 +146,9 @@ All of the MLA source code has been annotated with "DocBlocks", a special type o
|
|
127 |
|
128 |
== Upgrade Notice ==
|
129 |
|
|
|
|
|
|
|
130 |
= 0.41 =
|
131 |
Upgrade for the new Bulk Edit area; add, remove or replace taxonomy terms for several attachments at once. Sort your media listing on ALT Text, exclude revisions from where-used reporting.
|
132 |
|
@@ -145,6 +167,99 @@ You should upgrade to this version if you are getting "404 Not Found" errors whe
|
|
145 |
= 0.1 =
|
146 |
Initial release.
|
147 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
148 |
== Help Summary ==
|
149 |
<p><strong><em>Assistant Submenu - Attachment List Table</em></strong></p>
|
150 |
<p><strong>Overview</strong></p>
|
@@ -211,7 +326,8 @@ Initial release.
|
|
211 |
</ul>
|
212 |
<p><strong>Attachments Column</strong></p>
|
213 |
<p>The “Attachments” colunm at the right of the table gives you the number of attachments associated with each tag. You can click on the number to get a list of all the attachments with that tag. The heading on the list page(s) will display the tag value you’ve selected.</p>
|
214 |
-
|
|
|
215 |
|
216 |
I have used and learned much from the following books (among many):
|
217 |
|
4 |
Tags: attachments, documents, gallery, image, images, media, library, media library, media-tags, media tags, tags, media categories, categories
|
5 |
Requires at least: 3.3
|
6 |
Tested up to: 3.4.2
|
7 |
+
Stable tag: 0.50
|
8 |
License: GPLv2 or later
|
9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
10 |
|
11 |
+
Provides enhancements to the Media Library; powerful[mla_gallery], full taxonomy support, bulk & quick edit actions and where-used reporting.
|
|
|
12 |
|
13 |
== Description ==
|
14 |
|
15 |
The Media Library Assistant provides several enhancements for managing the Media Library, including:
|
16 |
|
17 |
+
* The **[mla_gallery] shortcode**, used in a post, page or custom post type to add a gallery of images and/or other Media Library items (such as PDF documents). [MLA Gallery](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Complete Documentation") is a superset of the [gallery] shortcode in the WordPress core; it is compatible with [gallery] and provides many enhancements. These include: 1) full support for WordPress categories, tags and custom taxonomies, 2) support for all post_mime_type values, not just images 3) media Library items need not be "attached" to the post.
|
18 |
+
|
19 |
* An inline "Bulk Edit" area; update author or parent, add, remove or replace taxonomy terms for several attachments at once.
|
20 |
* An inline "Quick Edit" action for many common fields.
|
21 |
* Complete support for ALL taxonomies, including the standard Categories and Tags, your custom taxonomies and the Assistant's pre-defined Att. Categories and Att. Tags. You can add taxonomy columns to the Assistant listing, filter on any taxonomy, assign terms and list the attachments for a term.
|
26 |
* Provides additional view filters for mime types and taxonomies
|
27 |
* Provides many more listing columns (more than 15) to choose from
|
28 |
|
29 |
+
The Assistant is designed to work like the standard Media Library pages, so the learning curve is short and gentle. Contextual help is provided on every new screen to highlight new features. The [Other Notes section](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Click here, then scroll down for Help Summary") contains a summary of the help text following the [mla_gallery] documentation.
|
30 |
|
31 |
+
This plugin was inspired by my work on the WordPress web site for our nonprofit, Fair Trade Judaica. If you find the Media Library Assistant plugin useful and would like to support a great cause, consider a [<strong>tax-deductible</strong> donation](http://fairtradejudaica.org/make-a-difference/donate/ "Support Our Work") to our work. Thank you!
|
32 |
|
33 |
== Installation ==
|
34 |
|
38 |
1. Visit the "Assistant" submenu in the Media admin section
|
39 |
1. Click the Screen Options link to customize the display
|
40 |
1. Use the enhanced Edit page to assign categories and tags
|
41 |
+
1. Use the [mla_gallery] shortcode to add galleries of images, documents and more to your posts and pages
|
42 |
|
43 |
== Frequently Asked Questions ==
|
44 |
|
45 |
+
= How can I use Categories, Tags and custom taxonomies to select images for display in my posts and pages? =
|
46 |
+
|
47 |
+
The powerful [mla_gallery] shortcode supports almost all of the query flexibility provided by the WP_Query class. You can find [complete documentation](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Complete Documentation") in the Other Notes section.
|
48 |
+
|
49 |
+
= Can I use [mla_gallery] for attachments other than images? =
|
50 |
+
|
51 |
+
Yes! The [mla_gallery] shortcode supports all MIME types. You can build a gallery of your PDF documents, plain text files and other attachments. You can mix images and other MIME types in the same gallery, too; check out [the documentation](http://wordpress.org/extend/plugins/media-library-assistant/other_notes/ "Complete Documentation").
|
52 |
+
|
53 |
+
= Can I attach an image to more than one post or page? =
|
54 |
+
|
55 |
+
No; that's a structural limitation of the WordPress database. However, you can use Categories, Tags and custom taxonomies to organize your images and associate them with posts and pages in any way you like. The [mla_gallery] shortcode makes it easy.
|
56 |
+
|
57 |
= Can the Assistant use the standard WordPress post Categories and Tags? =
|
58 |
|
59 |
Yes! You can activate or deactivate support for Categories and Tags at any time by visiting the Media Library Assistant Settings page.
|
97 |
|
98 |
== Changelog ==
|
99 |
|
100 |
+
= 0.50 =
|
101 |
+
* New: [mla_gallery] shortcode, a superset of the [gallery] shortcode that provides many enhancements. These include taxonomy support and all post_mime_type values (not just images). Media Library items need not be "attached" to the post.
|
102 |
+
* New: [mla_gallery] shortcode documentation added to Settings page
|
103 |
+
* New: Donate button and link added to Settings page
|
104 |
+
|
105 |
= 0.41 =
|
106 |
+
* Fix: SQL View (supporting ALT Text sorting) now created for automatic plugin upgrades
|
107 |
|
108 |
= 0.40 =
|
109 |
* New: Bulk Edit area; update author or parent, add, remove or replace taxonomy terms for several attachments at once
|
146 |
|
147 |
== Upgrade Notice ==
|
148 |
|
149 |
+
= 0.50 =
|
150 |
+
Upgrade for the new [mla_gallery] shortcode, a superset of the [gallery] shortcode that provides many enhancements. These include taxonomy support and all post_mime_type values (not just images).
|
151 |
+
|
152 |
= 0.41 =
|
153 |
Upgrade for the new Bulk Edit area; add, remove or replace taxonomy terms for several attachments at once. Sort your media listing on ALT Text, exclude revisions from where-used reporting.
|
154 |
|
167 |
= 0.1 =
|
168 |
Initial release.
|
169 |
|
170 |
+
==MLA Gallery Shortcode==
|
171 |
+
|
172 |
+
The [mla_gallery] shortcode is used in a post, page or custom post type to add a gallery of images and/or other Media Library items (such as PDF documents). MLA Gallery is a superset of the [gallery] shortcode in the WordPress core; it is compatible with [gallery] and provides many enhancements. These include:
|
173 |
+
|
174 |
+
* Full support for WordPress categories, tags and custom taxonomies. You can select items with any of the taxonomy parameters documented in the WP_Query class.
|
175 |
+
* Support for all post_mime_type values, not just images.
|
176 |
+
* Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.
|
177 |
+
|
178 |
+
All of the options/parameters documented for the [gallery] shortcode are supported by the [mla_gallery] shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the [mla_gallery] shortcode is designed to work with Media Library items, there are some parameter differences and extensions; these are documented below.
|
179 |
+
|
180 |
+
<h4>Include, Exclude</h4>
|
181 |
+
|
182 |
+
You can use "post_parent=all" to include or exclude attachments regardless of which post or page they are attached to. You can use "post_mime_type=all" to include or exclude attachments of all MIME types, not just images.
|
183 |
+
|
184 |
+
<h4>Size</h4>
|
185 |
+
|
186 |
+
The Size parameter specifies the image size to use for the thumbnail display. Valid values include "thumbnail", "medium", "large", "full" and any other additional image size that was registered with add_image_size(). The default value is "thumbnail". You can use "none" to suppress thumbnail display and substitute the item title string for the image.
|
187 |
+
|
188 |
+
The [mla_gallery] shortcode supports an additional Size value, "icon", which shows a 60x60 pixel thumbnail for image items and an appropriate icon for non-image items such as PDF or text files.
|
189 |
+
|
190 |
+
<h4>Order, Orderby</h4>
|
191 |
+
|
192 |
+
To order the gallery randomly, use "orderby=rand". To suppress gallery ordering you can use "orderby=none" or "order=rand".
|
193 |
+
|
194 |
+
The Orderby parameter specifies which database field is used to sort the gallery. You can order the gallery by any of the values documented for the WP_Query class reference in the Codex; you are NOT restricted to the values documented for the [gallery] shortcode.
|
195 |
+
|
196 |
+
<h4>Post ID, Post Parent</h4>
|
197 |
+
|
198 |
+
The "id" parameter lets you specify a post ID for your query. If the "id" parameter is not specified, the [mla_gallery] behavior differs from the [gallery] behavior. If your query uses taxonomy or custom field parameters, "author", "author_name" or "s" (search term), then the query will NOT be restricted to items attached to the current post. This lets you build a gallery with any combination of Media Library items that match the parameters.
|
199 |
+
|
200 |
+
You can use the "post_parent" to override the default behavior. If you set "post_parent" to a specific post ID, only the items attached to that post are displayed. If you set "post_parent" to "current", only the items attached to the current post are displayed. If you set "post_parent" to "all", the query will not have a post ID or post_parent parameter.
|
201 |
+
|
202 |
+
For example, `[mla_gallery tag="artisan"]` will display all images having the specified tag value, regardless of which post (if any) they are attached to. If you use `[mla_gallery tag="artisan" post_parent="current"]` it will display images having the specified tag value only if they are attached to the current post.
|
203 |
+
|
204 |
+
<h4>Author, Author Name</h4>
|
205 |
+
|
206 |
+
You can query by author's id or the "user_nicename" value (not the "display_name" value). Multiple author ID values are allowed, but only one author name value can be entered.
|
207 |
+
|
208 |
+
<h4>Category Parameters</h4>
|
209 |
+
|
210 |
+
Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
|
211 |
+
|
212 |
+
<h4>Tag Parameters</h4>
|
213 |
+
|
214 |
+
Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
|
215 |
+
|
216 |
+
Note that the "tag_id" parameter requires exactly one tag ID; multiple IDs are not allowed. You can use the "tag__in" parameter to query for multiple values.
|
217 |
+
|
218 |
+
<h4>Taxonomy Parameters</h4>
|
219 |
+
|
220 |
+
The [mla_gallery] shortcode supports the simple "{tax} (string)" values (deprecated as of WordPress version 3.1) as well as the more powerful "tax_query" value.
|
221 |
+
|
222 |
+
For simple queries, enter the taxonomy name and the term(s) that must be matched, e.g.:
|
223 |
+
|
224 |
+
* `[mla_gallery attachment_category='separate-category,another-category']`
|
225 |
+
|
226 |
+
Note that you must use the name/slug strings for taxonomy and terms, not the "title" strings.
|
227 |
+
|
228 |
+
More complex queries can be specified by using "tax_query", e.g.:
|
229 |
+
|
230 |
+
* `[mla_gallery tax_query="array(array('taxonomy' => 'attachment_tag','field' => 'slug','terms' => 'artisan'))"]`
|
231 |
+
* `[mla_gallery tax_query="array(array('taxonomy' => 'attachment_category','field' => 'id','terms' => array(11, 12)))" post_parent=current post_mime_type='']`
|
232 |
+
|
233 |
+
The first example is equivalent to the simple query "attachment_tag=artisan". The second example matches items of all MIME types, attached to the current post, having an attachment_category ID of 11 or 12.
|
234 |
+
|
235 |
+
When embedding the shortcode in the body of a post, be very careful when coding the tax_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML ‹br› tags and corrupt your query.
|
236 |
+
|
237 |
+
Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
|
238 |
+
|
239 |
+
<h4>Post Type, Post Status and Post MIME Type</h4>
|
240 |
+
|
241 |
+
For compatibility with the WordPress [gallery] shortcode, these parameters default to "post_type=attachment", "post_status=inherit" and "post_mime_type=image". You can override the defaults to, for example, display items in the trash ("post_status=trash") or PDF documents ("post_mime_type=application/pdf") or all MIME types ("post_mime_type=all"). I'm not sure why you'd want to override "post_type", but you are welcome to experiment and let me know what you find.
|
242 |
+
|
243 |
+
<h4>Pagination Parameters</h4>
|
244 |
+
|
245 |
+
The [mla_gallery] shortcode supplies "nopaging=true" as a default parameter. If you are working with a template that supports pagination you can replace this with specific values for "posts_per_page", "posts_per_archive_page", "paged" and/or "offset" . You can also pass "paged=current" to suppress the "nopaging" default; "current" will be replaced by the appropriate value (get_query_var('paged')).
|
246 |
+
|
247 |
+
<h4>Time Parameters</h4>
|
248 |
+
|
249 |
+
Support for time parameters is not included in the current version. I may add it later - let me know if you need it.
|
250 |
+
|
251 |
+
<h4>Custom Field Parameters</h4>
|
252 |
+
|
253 |
+
The [mla_gallery] shortcode supports the simple custom field parameters as well as the more powerful "meta_query" parameters made available as of WordPress 3.1.
|
254 |
+
|
255 |
+
When embedding the shortcode in the body of a post, be very careful when coding the meta_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML <br> tags and corrupt your query.
|
256 |
+
|
257 |
+
Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
|
258 |
+
|
259 |
+
<h4>Search Keywords</h4>
|
260 |
+
|
261 |
+
The search parameter ("s=keyword") will perform a keyword search. A cursory inspection of the code in /wp-includes/query.php reveals that the search includes the "post_title" and "post_content" (Description) fields but not the "post_excerpt" (Caption) field. An SQL "LIKE" clause is composed and added to the search criteria. I haven't done much testing of this parameter.
|
262 |
+
|
263 |
== Help Summary ==
|
264 |
<p><strong><em>Assistant Submenu - Attachment List Table</em></strong></p>
|
265 |
<p><strong>Overview</strong></p>
|
326 |
</ul>
|
327 |
<p><strong>Attachments Column</strong></p>
|
328 |
<p>The “Attachments” colunm at the right of the table gives you the number of attachments associated with each tag. You can click on the number to get a list of all the attachments with that tag. The heading on the list page(s) will display the tag value you’ve selected.</p>
|
329 |
+
|
330 |
+
== Acknowledgements ==
|
331 |
|
332 |
I have used and learned much from the following books (among many):
|
333 |
|
tpls/admin-display-settings-page.tpl
CHANGED
@@ -109,7 +109,7 @@
|
|
109 |
</td>
|
110 |
</tr>
|
111 |
<!-- template="page" -->
|
112 |
-
<div class="wrap">
|
113 |
<div id="icon-options-general" class="icon32"><br/></div>
|
114 |
<h2>Media Library Assistant [+version+] Settings</h2>
|
115 |
[+messages+]
|
@@ -125,9 +125,134 @@
|
|
125 |
[+_wpnonce+]
|
126 |
[+_wp_http_referer+]
|
127 |
</form>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
128 |
<h3>Plugin Documentation</h3>
|
129 |
<p>
|
130 |
If you are a developer interested in how this plugin is put together, you should
|
131 |
-
have a look at the <a title="Consult the phpDocs documentation" href="[+phpDocs_url+]" target="_blank">phpDocs documentation</a>.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
132 |
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
133 |
</div>
|
109 |
</td>
|
110 |
</tr>
|
111 |
<!-- template="page" -->
|
112 |
+
<a name="backtotop"></a><div class="wrap">
|
113 |
<div id="icon-options-general" class="icon32"><br/></div>
|
114 |
<h2>Media Library Assistant [+version+] Settings</h2>
|
115 |
[+messages+]
|
125 |
[+_wpnonce+]
|
126 |
[+_wp_http_referer+]
|
127 |
</form>
|
128 |
+
<p>
|
129 |
+
<a href="#backtotop">Go to Top</a>
|
130 |
+
</p>
|
131 |
+
<h3>Support Our Work</h3>
|
132 |
+
<table width="700" border="0" cellpadding="10">
|
133 |
+
<tr>
|
134 |
+
<td><a href="http://fairtradejudaica.org/make-a-difference/donate/" title="Donate to FTJ" target="_blank" style="border: none;"><img border="0" src="http://fairtradejudaica.org/wp-content/uploads/newsletter/images/DonateButton.jpg" width="100" height="40" alt="Donate"></a></td>
|
135 |
+
<td>This plugin was inspired by my work on the WordPress web site for our nonprofit, Fair Trade Judaica. If you find the Media Library Assistant plugin useful and would like to support a great cause, consider a <a href="http://fairtradejudaica.org/make-a-difference/donate/" title="Donate to FTJ" target="_blank" style="font-weight:bold">tax-deductible donation</a> to our work. Thank you!</td>
|
136 |
+
</tr>
|
137 |
+
</table>
|
138 |
<h3>Plugin Documentation</h3>
|
139 |
<p>
|
140 |
If you are a developer interested in how this plugin is put together, you should
|
141 |
+
have a look at the <a title="Consult the phpDocs documentation" href="[+phpDocs_url+]" target="_blank" style="font-size:14px; font-weight:bold">phpDocs documentation</a>.
|
142 |
+
</p>
|
143 |
+
<a name="mla_gallery"></a>
|
144 |
+
<p>
|
145 |
+
<a href="#backtotop">Go to Top</a>
|
146 |
+
</p>
|
147 |
+
<div class="mla_gallery_help" style="width:700px">
|
148 |
+
<h3>MLA Gallery Shortcode</h3>
|
149 |
+
<p>
|
150 |
+
The [mla_gallery] shortcode is used in a post, page or custom post type to add a gallery of images and/or other Media Library items (such as PDF documents). MLA Gallery is a superset of the [gallery] shortcode in the WordPress core; it is compatible with [gallery] and provides many enhancements. These include:
|
151 |
+
</p>
|
152 |
+
<ul class="mla_settings">
|
153 |
+
<li>Full support for WordPress categories, tags and custom taxonomies. You can select items with any of the taxonomy parameters documented in the WP_Query class.</li>
|
154 |
+
<li>Support for all post_mime_type values, not just images.</li>
|
155 |
+
<li>Media Library items need not be "attached" to the post. You can build a gallery with any combination of items in the Library using taxonomy terms, custom fields and more.</li>
|
156 |
+
</ul>
|
157 |
+
<p>
|
158 |
+
All of the options/parameters documented for the [gallery] shortcode are supported by the [mla_gallery] shortcode; you can find them in the WordPress Codex. Most of the parameters documented for the WP_Query class are also supported; see the WordPress Codex. Because the [mla_gallery] shortcode is designed to work with Media Library items, there are some parameter differences and extensions; these are documented below.
|
159 |
+
</p>
|
160 |
+
<h4>Include, Exclude</h4>
|
161 |
+
<p>
|
162 |
+
You can use "post_parent=all" to include or exclude attachments regardless of which post or page they are attached to. You can use "post_mime_type=all" to include or exclude attachments of all MIME types, not just images.
|
163 |
+
</p>
|
164 |
+
<h4>Size</h4>
|
165 |
+
<p>
|
166 |
+
The Size parameter specifies the image size to use for the thumbnail display. Valid values include "thumbnail", "medium", "large", "full" and any other additional image size that was registered with add_image_size(). The default value is "thumbnail". You can use "none" to suppress thumbnail display and substitute the item title string for the image.
|
167 |
+
</p>
|
168 |
+
<p>
|
169 |
+
The [mla_gallery] shortcode supports an additional Size value, "icon", which shows a 60x60 pixel thumbnail for image items and an appropriate icon for non-image items such as PDF or text files.
|
170 |
+
</p>
|
171 |
+
<h4>Order, Orderby</h4>
|
172 |
+
<p>
|
173 |
+
To order the gallery randomly, use "orderby=rand". To suppress gallery ordering you can use "orderby=none" or "order=rand".
|
174 |
+
</p>
|
175 |
+
<p>The Orderby parameter specifies which database field is used to sort the gallery. You can order the gallery by any of the values documented for the WP_Query class reference in the Codex; you are NOT restricted to the values documented for the [gallery] shortcode.
|
176 |
+
</p>
|
177 |
+
<h4>Post ID, Post Parent</h4>
|
178 |
+
<p>
|
179 |
+
The "id" parameter lets you specify a post ID for your query. If the "id" parameter is not specified, the [mla_gallery] behavior differs from the [gallery] behavior. If your query uses taxonomy or custom field parameters, "author", "author_name" or "s" (search term), then the query will NOT be restricted to items attached to the current post. This lets you build a gallery with any combination of Media Library items that match the parameters.
|
180 |
+
</p>
|
181 |
+
<p>
|
182 |
+
You can use the "post_parent" to override the default behavior. If you set "post_parent" to a specific post ID, only the items attached to that post are displayed. If you set "post_parent" to "current", only the items attached to the current post are displayed. If you set "post_parent" to "all", the query will not have a post ID or post_parent parameter.
|
183 |
+
</p>
|
184 |
+
<p>
|
185 |
+
For example, [mla_gallery tag="artisan"] will display all images having the specified tag value, regardless of which post (if any) they are attached to. If you use [mla_gallery tag="artisan" post_parent="current"] it will display images having the specified tag value only if they are attached to the current post.
|
186 |
+
</p>
|
187 |
+
<h4>Author, Author Name</h4>
|
188 |
+
<p>
|
189 |
+
You can query by author's id or the "user_nicename" value (not the "display_name" value). Multiple author ID values are allowed, but only one author name value can be entered.
|
190 |
+
</p>
|
191 |
+
<h4>Category Parameters</h4>
|
192 |
+
<p>
|
193 |
+
Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
|
194 |
+
</p>
|
195 |
+
<h4>Tag Parameters</h4>
|
196 |
+
<p>
|
197 |
+
Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
|
198 |
+
</p>
|
199 |
+
<p>
|
200 |
+
Note that the "tag_id" parameter requires exactly one tag ID; multiple IDs are not allowed. You can use the "tag__in" parameter to query for multiple values.
|
201 |
+
</p>
|
202 |
+
<h4>Taxonomy Parameters</h4>
|
203 |
+
<p>
|
204 |
+
The [mla_gallery] shortcode supports the simple "{tax} (string)" values (deprecated as of WordPress version 3.1) as well as the more powerful "tax_query" value.
|
205 |
+
</p>
|
206 |
+
<p>
|
207 |
+
For simple queries, enter the taxonomy name and the term(s) that must be matched, e.g.:
|
208 |
+
</p>
|
209 |
+
<ul class="mla_settings">
|
210 |
+
<li>[mla_gallery attachment_category='separate-category,another-category']</li>
|
211 |
+
</ul>
|
212 |
+
<p>
|
213 |
+
Note that you must use the name/slug strings for taxonomy and terms, not the "title" strings.
|
214 |
+
</p>
|
215 |
+
<p>
|
216 |
+
More complex queries can be specified by using "tax_query", e.g.:
|
217 |
+
</p>
|
218 |
+
<ul class="mla_settings">
|
219 |
+
<li>[mla_gallery tax_query="array(array('taxonomy' => 'attachment_tag','field' => 'slug','terms' => 'artisan'))"]</li>
|
220 |
+
<li>[mla_gallery tax_query="array(array('taxonomy' => 'attachment_category','field' => 'id','terms' => array(11, 12)))" post_parent=current post_mime_type='']</li>
|
221 |
+
</ul>
|
222 |
+
<p>
|
223 |
+
The first example is equivalent to the simple query "attachment_tag=artisan". The second example matches items of all MIME types, attached to the current post, having an attachment_category ID of 11 or 12.
|
224 |
+
</p>
|
225 |
+
<p>
|
226 |
+
When embedding the shortcode in the body of a post, be very careful when coding the tax_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML ‹br› tags and corrupt your query.
|
227 |
+
</p>
|
228 |
+
<p>
|
229 |
+
Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
|
230 |
</p>
|
231 |
+
<h4>Post Type, Post Status and Post MIME Type</h4>
|
232 |
+
<p>
|
233 |
+
For compatibility with the WordPress [gallery] shortcode, these parameters default to "post_type=attachment", "post_status=inherit" and "post_mime_type=image". You can override the defaults to, for example, display items in the trash ("post_status=trash") or PDF documents ("post_mime_type=application/pdf") or all MIME types ("post_mime_type=all"). I'm not sure why you'd want to override "post_type", but you are welcome to experiment and let me know what you find.
|
234 |
+
</p>
|
235 |
+
<h4>Pagination Parameters</h4>
|
236 |
+
<p>
|
237 |
+
The [mla_gallery] shortcode supplies "nopaging=true" as a default parameter. If you are working with a template that supports pagination you can replace this with specific values for "posts_per_page", "posts_per_archive_page", "paged" and/or "offset" . You can also pass "paged=current" to suppress the "nopaging" default; "current" will be replaced by the appropriate value (get_query_var('paged')).
|
238 |
+
</p>
|
239 |
+
<h4>Time Parameters</h4>
|
240 |
+
<p>
|
241 |
+
Support for time parameters is not included in the current version. I may add it later - let me know if you need it.
|
242 |
+
</p>
|
243 |
+
<h4>Custom Field Parameters</h4>
|
244 |
+
<p>
|
245 |
+
The [mla_gallery] shortcode supports the simple custom field parameters as well as the more powerful "meta_query" parameters made available as of WordPress 3.1.
|
246 |
+
</p>
|
247 |
+
<p>
|
248 |
+
When embedding the shortcode in the body of a post, be very careful when coding the meta_query; it must be a valid PHP array specification. In particular, code the query on one line; splitting it across lines can insert HTML <br> tags and corrupt your query.
|
249 |
+
</p>
|
250 |
+
<p>
|
251 |
+
Remember to use "post_parent=current" if you want to restrict your query to items attached to the current post.
|
252 |
+
</p>
|
253 |
+
<h4>Search Keywords</h4>
|
254 |
+
<p>
|
255 |
+
The search parameter ("s=keyword") will perform a keyword search. A cursory inspection of the code in /wp-includes/query.php reveals that the search includes the "post_title" and "post_content" (Description) fields but not the "post_excerpt" (Caption) field. An SQL "LIKE" clause is composed and added to the search criteria. I haven't done much testing of this parameter.
|
256 |
+
</p>
|
257 |
+
</div>
|
258 |
</div>
|
tpls/help-for-media_page_mla-menu.tpl
CHANGED
@@ -3,7 +3,7 @@
|
|
3 |
<p>All the files you’ve uploaded are listed in the Media Library Assistant table, ordered by the Title field. You can change the sort order by clicking on one of the blue column names. You can change the default sort order on the Settings screen.</p>
|
4 |
<p>You can use the Screen Options tab to customize the display of this screen. You can choose any combination of the sixteen (16) columns available for display. You can also choose how many items appear on each page of the display.</p>
|
5 |
<p>You can narrow the list by file type/status using the text link filters at the top of the screen. You also can refine the list by month using the dropdown menu above the media table.</p>
|
6 |
-
<p>If you have selected “
|
7 |
<p><strong>NOTE:</strong> Month and category filters are “sticky”, i.e., they will persist as you resort the display or change the file type/status view.</p>
|
8 |
<!-- template="mla-featured-inserted" -->
|
9 |
<!-- title="Featured/Inserted" order="2" -->
|
3 |
<p>All the files you’ve uploaded are listed in the Media Library Assistant table, ordered by the Title field. You can change the sort order by clicking on one of the blue column names. You can change the default sort order on the Settings screen.</p>
|
4 |
<p>You can use the Screen Options tab to customize the display of this screen. You can choose any combination of the sixteen (16) columns available for display. You can also choose how many items appear on each page of the display.</p>
|
5 |
<p>You can narrow the list by file type/status using the text link filters at the top of the screen. You also can refine the list by month using the dropdown menu above the media table.</p>
|
6 |
+
<p>If you have selected taxonomy support, e.g., “Att. Categories”, you can filter the list by selecting “All Categories”, “No Categories” or a specific category from the drop down list. If you select a category that has child categories beneath it, attachments in any of the child categories will also appear in the filtered list. You can select the taxonomy you want to filter by on the Settings page.</p>
|
7 |
<p><strong>NOTE:</strong> Month and category filters are “sticky”, i.e., they will persist as you resort the display or change the file type/status view.</p>
|
8 |
<!-- template="mla-featured-inserted" -->
|
9 |
<!-- title="Featured/Inserted" order="2" -->
|