PluginProbe
FeedWordPress / 2022.0222
FeedWordPress v2022.0222
trunk 0.8 0.9 0.91 0.95 0.96 0.97 0.98 0.981 0.99 0.991 0.992 0.993 2008.1030 2008.1101 2008.1105 2008.1214 2009.0612 2009.0613 2009.0618 2009.0707 2009.1111 2009.1112 2010.0127 2010.0528 All 65 releases
← All changes | admin-ui.php +657 -693 2009.11112022.0222 View file →
@@ -1,512 +1,411 @@
1 1 <?php
2 -class FeedWordPressAdminPage {
3 - var $context;
4 - var $updated = false;
5 - var $link = NULL;
6 - var $dispatch = NULL;
7 - var $filename = NULL;
2 +/**
3 + * Admin UI Compatibility (admin-ui.php): This is kind of a junk pile of utility functions
4 + * mostly created to smooth out interactions to make things show up, or behave correctly,
5 + * within the WordPress admin settings interface. Major chunks of this code that deal with
6 + * making it easy for FWP, add-on modules, etc. to create new settings panels have since
7 + * been hived off into class FeedWordPressAdminPage. Many of the functions that remain here
8 + * were created to handle compatibility across multiple, sometimes very old, versions of
9 + * WordPress, many of which are no longer supported anymore. It's likely that some of these
10 + * functions will be re-evaluated, re-organized, deprecated, or clipped out in the next few
11 + * versions.
12 + * -cj 2017-10-27
13 + *
14 + * @package FeedWordPress
15 + */
8 16
9 - /**
10 - * Construct the admin page object.
11 - *
12 - * @param mixed $link An object of class {@link SyndicatedLink} if created for one feed's settings, NULL if created for global default settings
13 - */
14 - function FeedWordPressAdminPage ($page = 'feedwordpressadmin', $link = NULL) {
15 - $this->link = $link;
17 +$dir = dirname( __FILE__ );
18 +require_once "${dir}/feedwordpressadminpage.class.php";
19 +require_once "${dir}/feedwordpresssettingsui.class.php";
16 20
17 - // Set meta-box context name
18 - $this->context = $page;
19 - if ($this->for_feed_settings()) :
20 - $this->context .= 'forfeed';
21 - endif;
22 - } /* FeedWordPressAdminPage constructor */
21 +/**
22 + * Prints the class="..." attribute (if any) for an HTML form element
23 + *
24 + * If there is at least one class to add to the element, escape it for attribute contet and print;
25 + * if not, omit the attribute entirely.
26 + *
27 + * @param string $class_name The name(s) of the HTML class or classes to apply.
28 + * @param string $before Separator prefix string to print just before class="..." attribute, when printed (usually whitespace).
29 + * @param string $after Separator suffix string to print just after class="..." attribute, when printed (usually blank).
30 + */
31 +function fwp_form_class_attr( $class_name, $before = ' ', $after = '' ) {
23 32
24 - function for_feed_settings () { return (is_object($this->link) and method_exists($this->link, 'found') and $this->link->found()); }
25 - function for_default_settings () { return !$this->for_feed_settings(); }
26 -
27 - /*static*/ function submitted_link_id () {
28 - global $fwp_post;
29 -
30 - // Presume global unless we get a specific link ID
31 - $link_id = NULL;
32 -
33 - $submit_buttons = array(
34 - 'save',
35 - 'submit',
36 - 'fix_mismatch',
37 - 'feedfinder',
38 - );
39 - foreach ($submit_buttons as $field) :
40 - if (isset($fwp_post[$field])) :
41 - $link_id = $_REQUEST['save_link_id'];
42 - endif;
43 - endforeach;
44 -
45 - if (is_null($link_id) and isset($_REQUEST['link_id'])) :
46 - $link_id = $_REQUEST['link_id'];
33 + if ( is_string( $class_name ) ) :
34 + if ( strlen( $class_name ) > 0 ) :
35 + $s_class_name = sanitize_html_class( $class_name );
36 + printf( '%sclass="%s"%s', esc_html( $before ), esc_attr( $s_class_name ), esc_html( $after ) );
47 37 endif;
38 + endif;
48 39
49 - return $link_id;
50 - } /* FeedWordPressAdminPage::submitted_link_id() */
40 +} /* fwp_form_class_attr() */
51 41
52 - /*static*/ function submitted_link () {
53 - $link_id = FeedWordPressAdminPage::submitted_link_id();
54 - if (is_numeric($link_id) and $link_id) :
55 - $link =& new SyndicatedLink($link_id);
56 - else :
57 - $link = NULL;
58 - endif;
59 - return $link;
60 - } /* FeedWordPressAdminPage::submitted_link () */
42 +/**
43 + * Prints a flag attribute for selected UI elements (selected="selected" or checked="checked", etc.) when appropriate
44 + *
45 + * In HTML form output templates, this allows conditional output of the selected="selected"
46 + * (or checked="checked", etc.) attribute on input or option controls when appropriate, and
47 + * omits the element when not appropriate, as measured by a flag that is monitored and updated
48 + * by the caller.
49 + *
50 + * @param mixed $arg Flag monitoring variable.
51 + * @param mixed $key When $arg is an array, $key provides the index within the array to check for the flag.
52 + * @param string $flag The name of the flag attribute to output when appropriate; default, "selected".
53 + */
54 +function fwp_selected_flag( /* mixed */ $arg = null, $key = null, $flag = 'selected' ) {
61 55
62 - function stamp_link_id ($field = null) {
63 - if (is_null($field)) : $field = 'save_link_id'; endif;
64 - ?>
65 - <input type="hidden" name="<?php print wp_specialchars($field, 'both'); ?>" value="<?php print ($this->for_feed_settings() ? $this->link->id : '*'); ?>" />
66 - <?php
67 - } /* FeedWordPressAdminPage::stamp_link_id () */
56 + $is_on = false;
68 57
69 - function these_posts_phrase () {
70 - if ($this->for_feed_settings()) :
71 - $phrase = __('posts from this feed');
58 + $s_arg = $arg;
59 + if ( is_array( $arg ) && ! is_null( $key ) ) :
60 + if ( array_key_exists( $key, $arg ) ) :
61 + $s_arg = $arg[ $key ];
72 62 else :
73 - $phrase = __('syndicated posts');
63 + $s_arg = false;
74 64 endif;
75 - return $phrase;
76 - } /* FeedWordPressAdminPage::these_posts_phrase() */
65 + endif;
77 66
78 - /**
79 - * Provides a uniquely identifying name for the interface context for
80 - * use with add_meta_box() and do_meta_boxes(),
81 - *
82 - * @return string the context name
83 - *
84 - * @see add_meta_box()
85 - * @see do_meta_boxes()
86 - */
87 - function meta_box_context () {
88 - return $this->context;
89 - } /* FeedWordPressAdminPage::meta_box_context () */
90 -
91 - /**
92 - * Outputs JavaScript to fix AJAX toggles settings.
93 - *
94 - * @uses FeedWordPressAdminPage::meta_box_context()
95 - */
96 - function fix_toggles () {
97 - FeedWordPressSettingsUI::fix_toggles_js($this->meta_box_context());
98 - } /* FeedWordPressAdminPage::fix_toggles() */
67 + if ( is_string( $s_arg ) ) :
68 + $is_on = ( strlen( $s_arg ) > 0 );
69 + else :
70 + $is_on = (bool) ( $s_arg );
71 + endif;
99 72
100 - function ajax_interface_js () {
101 -?>
102 -<script type="text/javascript">
103 - function contextual_appearance (item, appear, disappear, value, visibleStyle, checkbox) {
104 - if (typeof(visibleStyle)=='undefined') visibleStyle = 'block';
73 + if ( $is_on ) :
74 + print sprintf( '%s="%s"', esc_attr( $flag ), esc_attr( $flag ) );
75 + endif;
76 +} /* fwp_selected_flag() */
105 77
106 - var rollup=document.getElementById(item);
107 - var newuser=document.getElementById(appear);
108 - var sitewide=document.getElementById(disappear);
109 - if (rollup) {
110 - if ((checkbox && rollup.checked) || (!checkbox && value==rollup.value)) {
111 - if (newuser) newuser.style.display=visibleStyle;
112 - if (sitewide) sitewide.style.display='none';
113 - } else {
114 - if (newuser) newuser.style.display='none';
115 - if (sitewide) sitewide.style.display=visibleStyle;
116 - }
117 - }
118 - }
119 -</script>
78 +/**
79 + * Outputs a flag attribute for checked UI elements (checked="checked") when appropriate
80 + *
81 + * In HTML form output templates, this allows conditional output of the check="checked"
82 + * attribute on input controls (e.g. checkbox, radio) when appropriate, and omits when
83 + * inappropriate (unchecked), as determined by a flag monitored and updated by caller.
84 + *
85 + * @param mixed $arg Flag monitoring variable.
86 + * @param mixed $key When $arg is an array, $key provides index within the array to check for flag value.
87 + *
88 + * @uses fwp_selected_flag()
89 + */
90 +function fwp_checked_flag( /* mixed */ $arg = null, $key = null ) {
91 + fwp_selected_flag( $arg, $key, 'checked' );
92 +} /* fwp_checked_flag() */
120 93
121 -<?php
122 - } /* FeedWordPressAdminPage::ajax_interface_js () */
94 +/**
95 + * Retrieves a plural or singular form of a string based on the supplied number.
96 + *
97 + * Used when you want to use the appropriate form of a string based on whether
98 + * a number is singular or plural. Very similar to WordPress l10n.php _n(),
99 + * but designed for a nice short form in the
100 + * default case (provide "s" when plural, "" otherwise).
101 + *
102 + * @param int $n The counter to determine singular or plural form.
103 + * @param string $plural The text to use if the counter is plural.
104 + * @param string $singular The text to use if the counter is singular.
105 + *
106 + * @return string The text of the singular or plural form.
107 + */
108 +function _s( $n = 0, $plural = 's', $singular = '' ) {
109 + $is_singular = ( is_numeric( $n ) && intval( $n ) === 1 );
110 + return ( $is_singular ? $singular : $plural );
111 +}
123 112
124 - function display_feed_select_dropdown() {
125 - $links = FeedWordPress::syndicated_links();
126 - if (fwp_test_wp_version(FWP_SCHEMA_27)) :
127 - ?>
128 - <style type="text/css">
129 - #post-search {
130 - float: right;
131 - margin:11px 12px 0;
132 - min-width: 130px;
133 - position:relative;
134 - }
135 - .fwpfs {
136 - color: #dddddd;
137 - background:#797979 url(<?php bloginfo('home') ?>/wp-admin/images/fav.png) repeat-x scroll left center;
138 - border-color:#777777 #777777 #666666 !important; -moz-border-radius-bottomleft:12px;
139 - -moz-border-radius-bottomright:12px;
140 - -moz-border-radius-topleft:12px;
141 - -moz-border-radius-topright:12px;
142 - border-style:solid;
143 - border-width:1px;
144 - line-height:15px;
145 - padding:3px 30px 4px 12px;
146 - }
147 - .fwpfs.slide-down {
148 - border-bottom-color: #626262;
149 - -moz-border-radius-bottomleft:0;
150 - -moz-border-radius-bottomright:0;
151 - -moz-border-radius-topleft:12px;
152 - -moz-border-radius-topright:12px;
153 - background-image:url(<?php bloginfo('home') ?>/wp-admin/images/fav-top.png);
154 - background-position:0 top;
155 - background-repeat:repeat-x;
156 - border-bottom-style:solid;
157 - border-bottom-width:1px;
158 - }
159 - </style>
160 -
161 - <script type="text/javascript">
162 - jQuery(document).ready(function($){
163 - $('.fwpfs').toggle(
164 - function(){$('.fwpfs').removeClass('slideUp').addClass('slideDown'); setTimeout(function(){if ( $('.fwpfs').hasClass('slideDown') ) { $('.fwpfs').addClass('slide-down'); }}, 10) },
165 - function(){$('.fwpfs').removeClass('slideDown').addClass('slideUp'); setTimeout(function(){if ( $('.fwpfs').hasClass('slideUp') ) { $('.fwpfs').removeClass('slide-down'); }}, 10) }
166 - );
167 - $('.fwpfs').bind(
168 - 'change',
169 - function () { this.form.submit(); }
170 - );
171 - $('#post-search .button').css( 'display', 'none' );
172 - });
173 - </script>
174 - <?php
175 - endif;
176 -
177 - ?>
178 - <p id="post-search">
179 - <select name="link_id" class="fwpfs" style="max-width: 20.0em;">
180 - <option value="*"<?php if ($this->for_default_settings()) : ?> selected="selected"<?php endif; ?>>- defaults for all feeds -</option>
181 - <?php if ($links) : foreach ($links as $ddlink) : ?>
182 - <option value="<?php print (int) $ddlink->link_id; ?>"<?php if (!is_null($this->link) and ($this->link->id==$ddlink->link_id)) : ?> selected="selected"<?php endif; ?>><?php print wp_specialchars($ddlink->link_name, 1); ?></option>
183 - <?php endforeach; endif; ?>
184 - </select>
185 - <input class="button" type="submit" name="go" value="<?php _e('Go') ?> &raquo;" />
186 - </p>
187 - <?php
188 - } /* FeedWordPressAdminPage::display_feed_select_dropdown() */
113 +/**
114 + * Outputs a status message for the aggregate results of polling a set of feeds.
115 + *
116 + * This will always output the number of new syndicated posts added, even if this is 0.
117 + * Posts updated and alternate versions stored will be added to the message iff > 0.
118 + *
119 + * @param array $delta Counters indicating results in "new", "updated" and "stored".
120 + * @param string $joiner Default ';'. Delimiter used to separate messages about new, updated and stored posts.
121 + */
122 +function fwp_update_set_results_message( $delta, $joiner = ';' ) {
189 123
190 - function display_sheet_header ($pagename = 'Syndication', $all = false) {
191 - if (FeedWordPressCompatibility::test_version(FWP_SCHEMA_27)) :
192 - ?>
193 - <div class="icon32"><img src="<?php print wp_specialchars(WP_PLUGIN_URL.'/'.$GLOBALS['fwp_path'].'/feedwordpress.png', 1); ?>" alt="" /></div>
194 - <?php
195 - endif;
196 - ?>
124 + $mesg = array();
197 125
198 - <h2><?php print wp_specialchars(__($pagename.($all ? '' : ' Settings')), 1); ?><?php if ($this->for_feed_settings()) : ?>: <?php echo wp_specialchars($this->link->link->link_name, 1); ?><?php endif; ?></h2>
199 - <?php
200 - }
126 + $delta = wp_parse_args(
127 + $delta,
128 + array(
129 + 'new' => 0,
130 + 'updated' => 0,
131 + 'stored' => 0,
132 + )
133 + );
201 134
202 - function display_update_notice_if_updated ($pagename = 'Syndication', $mesg = NULL) {
203 - if ($this->updated) :
204 - if ($this->updated === true) :
205 - $mesg = $pagename . ' settings updated.';
206 - else :
207 - $mesg = $this->updated;
208 - endif;
209 - endif;
210 -
211 - if (!is_null($mesg)) :
212 - ?>
213 - <div class="updated">
214 - <p><?php print wp_specialchars($mesg, 1); ?></p>
215 - </div>
216 - <?php
217 - endif;
218 - } /* FeedWordPressAdminPage::display_update_notice_if_updated() */
135 + $mesg[] = sprintf( ' %d new post%s syndicated', intval( $delta['new'] ), _s( $delta['new'], 's were', ' was' ) );
136 + if ( $delta['updated'] > 0 ) :
137 + $mesg[] = sprintf( ' %d existing post%s updated', intval( $delta['updated'] ), _s( $delta['updated'], 's were', ' was' ) );
138 + endif;
139 + if ( $delta['stored'] > 0 ) :
140 + $mesg[] = sprintf( ' %d alternate version%s of existing post%s stored for reference', intval( $delta['stored'] ), _s( $delta['stored'] ), _s( $delta['stored'], 's were', ' was' ) );
141 + endif;
219 142
220 - function display_settings_scope_message () {
221 - if ($this->for_feed_settings()) :
222 - ?>
223 - <p>These settings only affect posts syndicated from
224 - <strong><?php echo wp_specialchars($this->link->link->link_name, 1); ?></strong>.</p>
225 - <?php
226 - else :
227 - ?>
228 - <p>These settings affect posts syndicated from any feed unless they are overridden
229 - by settings for that specific feed.</p>
230 - <?php
231 - endif;
232 - } /* FeedWordPressAdminPage::display_settings_scope_message () */
233 -
234 - /*static*/ function has_link () { return true; }
143 + if ( ! is_null( $joiner ) ) :
144 + $mesg = implode( $joiner, $mesg );
145 + endif;
146 + return $mesg;
147 +} /* function fwp_update_set_results_message () */
235 148
236 - function open_sheet ($header) {
237 - // Set up prepatory AJAX stuff
238 - $this->ajax_interface_js();
239 - if (function_exists('add_meta_box')) :
240 - add_action(
241 - FeedWordPressCompatibility::bottom_script_hook($this->filename),
242 - /*callback=*/ array($this, 'fix_toggles'),
243 - /*priority=*/ 10000
244 - );
245 - FeedWordPressSettingsUI::ajax_nonce_fields();
246 - endif;
247 -
248 - ?>
249 - <div class="wrap" style="position:relative">
250 - <?php
251 - if (!is_null($header)) :
252 - $this->display_sheet_header($header);
253 - endif;
254 -
255 - if (!is_null($this->dispatch)) :
256 - ?>
257 - <form action="admin.php?page=<?php print $GLOBALS['fwp_path']; ?>/<?php echo basename($this->filename); ?>" method="post">
258 - <div><?php
259 - FeedWordPressCompatibility::stamp_nonce($this->dispatch);
260 - $this->stamp_link_id();
261 - ?></div>
262 - <?php
263 - endif;
264 -
265 - if ($this->has_link()) :
266 - $this->display_feed_select_dropdown();
267 - $this->display_settings_scope_message();
268 - endif;
269 -
270 - if (function_exists('do_meta_boxes')) :
271 - ?>
272 - <div id="poststuff">
273 - <?php
274 - else :
275 - ?>
276 - </div> <!-- class="wrap" -->
277 - <?php
278 - endif;
279 -
280 - if (!is_null($this->dispatch)) :
281 - fwp_settings_form_single_submit();
282 - endif;
283 - } /* FeedWordPressAdminPage::open_sheet () */
284 -
285 - function close_sheet () {
286 - // WordPress 2.5+
287 - if (function_exists('do_meta_boxes')) :
288 - ?>
289 - </div> <!-- id="poststuff" -->
290 - <?php if (!is_null($this->dispatch)) : ?>
291 - <?php fwp_settings_form_single_submit_closer(); ?>
292 - </form>
293 - <?php endif; ?>
294 - </div> <!-- class="wrap" -->
295 - <?php
296 - endif;
297 - }
298 -} /* class FeedWordPressAdminPage */
299 -
300 -function fwp_settings_form_single_submit ($caption = NULL) {
301 - if (fwp_test_wp_version(FWP_SCHEMA_25, FWP_SCHEMA_27)) :
302 - if (is_null($caption)) : $caption = __('Save'); endif;
303 -?>
149 +/**
150 + * Outputs the HTML template for a "Submit" button on FWP admin pages.
151 + *
152 + * @param mixed $link The syndicated link, if any, that we are viewing settings for.
153 + */
154 +function fwp_authors_single_submit( $link = null ) {
155 + ?>
304 156 <div class="submitbox" id="submitlink">
305 -<div id="previewview"></div>
306 -<div class="inside"></div>
157 +<div id="previewview">
158 +</div>
159 +<div class="inside">
160 +</div>
307 161
308 162 <p class="submit">
309 -<input type="submit" name="save" value="<?php print $caption; ?>" />
163 +<input type="submit" name="save" value="<?php esc_html_e( 'Save' ); ?>" />
310 164 </p>
311 165 </div>
312 -<?php
166 + <?php
167 +}
168 +
169 +/**
170 + * Outputs the HTML template for a Tags (or similar taxonomy) add / remove box in FeedWordPress admin UI pages.
171 + *
172 + * @param array $tags An array of tags already applied to the object.
173 + * @param string $object The human-readable description of the objects to be tagged ("post", "posts from this feed", etc.).
174 + * @param array $params An array of optional parameters.
175 + */
176 +function fwp_tags_box( $tags, $object, $params = array() ) {
177 + $params = wp_parse_args(
178 + $params,
179 + array( // Default values.
180 + 'taxonomy' => 'post_tag',
181 + 'textarea_name' => null,
182 + 'textarea_id' => null,
183 + 'input_id' => null,
184 + 'input_name' => null,
185 + 'id' => null,
186 + 'box_title' => __( 'Post Tags' ),
187 + )
188 + );
189 +
190 + if ( ! is_array( $tags ) ) :
191 + $tags = array();
313 192 endif;
314 -}
315 193
316 -function fwp_settings_form_periodic_submit ($caption = NULL) {
317 - if (!fwp_test_wp_version(FWP_SCHEMA_25)) :
318 - if (is_null($caption)) : $caption = __('Save Changes &raquo;'); endif;
319 -?>
320 -<p class="submit">
321 -<input type="submit" name="save" value="<?php print $caption; ?>" />
322 -</p>
323 -<?php
194 + $tax_name = $params['taxonomy'];
195 + $o_tax = get_taxonomy( $params['taxonomy'] );
196 + $o_tax_labels = get_taxonomy_labels( $o_tax );
197 + $is_enabled = current_user_can( $o_tax->cap->assign_terms );
198 +
199 + if ( is_null( $params['textarea_name'] ) ) :
200 + $params['textarea_name'] = "tax_input[$tax_name]";
324 201 endif;
325 -}
202 + if ( is_null( $params['textarea_id'] ) ) :
203 + $params['textarea_id'] = "tax-input-${tax_name}";
204 + endif;
205 + if ( is_null( $params['input_id'] ) ) :
206 + $params['input_id'] = "new-tag-${tax_name}";
207 + endif;
208 + if ( is_null( $params['input_name'] ) ) :
209 + $params['input_name'] = "newtag[$tax_name]";
210 + endif;
326 211
327 -function fwp_settings_form_single_submit_closer ($caption = NULL) {
328 - if (fwp_test_wp_version(FWP_SCHEMA_27)) :
329 - if (is_null($caption)) : $caption = __('Save Changes'); endif;
330 -?>
331 -<p class="submit">
332 -<input class="button-primary" type="submit" name="save" value="<?php print $caption; ?>" />
333 -</p>
334 -<?php
212 + if ( is_null( $params['id'] ) ) :
213 + $params['id'] = $tax_name;
335 214 endif;
336 -}
337 215
338 -function fwp_authors_single_submit ($link = NULL) {
339 - global $wp_db_version;
340 -
341 - if (fwp_test_wp_version(FWP_SCHEMA_25)) :
342 -?>
343 -<div class="submitbox" id="submitlink">
344 -<div id="previewview">
345 -</div>
346 -<div class="inside">
347 -</div>
216 + printf( /* $desc = */ '<p style="font-size:smaller;font-style:bold;margin:0\">Tag %s as...</p>', esc_html( $object ) );
217 + $helps = __( 'Separate tags with commas.' );
218 + $box['title'] = __( 'Tags' );
219 + ?>
220 +<div class="tagsdiv" id="<?php echo esc_attr( $params['id'] ); ?>">
221 + <div class="jaxtag">
222 + <div class="nojs-tags hide-if-js">
223 + <p><?php echo esc_html( $o_tax_labels->add_or_remove_items ); ?></p>
224 + <textarea name="<?php echo esc_attr( $params['textarea_name'] ); ?>" class="the-tags" id="<?php echo esc_attr( $params['textarea_id'] ); ?>"><?php echo esc_attr( implode( ',', $tags ) ); ?></textarea></div>
348 225
349 -<p class="submit">
350 -<input type="submit" name="save" value="<?php _e('Save') ?>" />
351 -</p>
226 + <?php if ( $is_enabled ) : ?>
227 + <div class="ajaxtag hide-if-no-js">
228 + <label class="screen-reader-text" for="<?php echo esc_attr( $params['input_id'] ); ?>"><?php echo esc_html( $params['box_title'] ); ?></label>
229 + <div class="taghint"><?php echo esc_html( $o_tax_labels->add_new_item ); ?></div>
230 + <p><input type="text" id="<?php print esc_attr( $params['input_id'] ); ?>" name="<?php print esc_attr( $params['input_name'] ); ?>" class="newtag form-input-tip" size="16" autocomplete="off" value="" />
231 + <input type="button" class="button tagadd" value="<?php esc_attr_e( 'Add' ); ?>" tabindex="3" /></p>
232 + </div>
233 + <p class="howto"><?php echo esc_attr( $o_tax_labels->separate_items_with_commas ); ?></p>
234 + <?php endif; ?>
235 + </div>
236 +
237 + <div class="tagchecklist"></div>
352 238 </div>
353 -<?php
239 + <?php
240 + if ( $is_enabled ) :
241 + ?>
242 +<p class="hide-if-no-js"><a href="#titlediv" class="tagcloud-link" id="link-<?php echo esc_attr( $tax_name ); ?>"><?php echo esc_html( $o_tax_labels->choose_from_most_used ); ?></a></p>
243 + <?php
354 244 endif;
355 -}
356 245
357 -function fwp_option_box_opener ($legend, $id, $class = "stuffbox") {
358 - // WordPress 2.5+
359 - if (FeedWordPressCompatibility::test_version(FWP_SCHEMA_25)) :
360 -?>
361 -<div id="<?php print $id; ?>" class="<?php print $class; ?>">
362 -<h3><?php print htmlspecialchars($legend); ?></h3>
363 -<div class="inside">
364 -<?php
365 - else :
366 -?>
367 - <div class="wrap">
368 - <h2><?php print htmlspecialchars($legend); ?></h2>
369 -<?php
370 - endif;
371 246 }
372 247
373 -function fwp_option_box_closer () {
248 +/**
249 + * Outputs the HTML template for a Category (or similar taxonomy) add / remove box in FeedWordPress admin UI pages.
250 + *
251 + * @param array $checked An array of cats already applied to the object.
252 + * @param string $object The human-readable description of the objects to be tagged ("post", "posts from this feed", etc.).
253 + * @param array $tags Not used.
254 + * @param array $params An array of optional parameters.
255 + */
256 +function fwp_category_box( $checked, $object, $tags = array(), $params = array() ) {
374 257 global $wp_db_version;
375 - if (isset($wp_db_version) and $wp_db_version >= FWP_SCHEMA_25) :
376 -?>
377 - </div> <!-- class="inside" -->
378 - </div> <!-- class="stuffbox" -->
379 -<?php
380 - else :
381 -?>
382 - </div> <!-- class="wrap" -->
383 -<?php
258 +
259 + if ( is_string( $params ) ) :
260 + $prefix = $params;
261 + $taxonomy = 'category';
262 + elseif ( is_array( $params ) ) :
263 + $params = wp_parse_args(
264 + $params,
265 + array(
266 + 'prefix' => '',
267 + 'taxonomy' => 'category',
268 + )
269 + );
270 +
271 + $prefix = $params['prefix'];
272 + $taxonomy = $params['taxonomy'];
384 273 endif;
385 -}
386 274
387 -function fwp_tags_box ($tags, $object) {
388 - if (!is_array($tags)) : $tags = array(); endif;
389 -
390 - $desc = "<p style=\"font-size:smaller;font-style:bold;margin:0\">Tag $object as...</p>";
275 + $o_tax = get_taxonomy( $taxonomy );
276 + $o_tax_labels = get_taxonomy_labels( $o_tax );
391 277
392 - if (fwp_test_wp_version(FWP_SCHEMA_28)) : // WordPress 2.8+
393 -?>
394 - <?php print $desc; ?>
395 - <div class="tagsdiv" id="post_tag">
396 - <div class="jaxtag">
397 - <div class="nojs-tags hide-if-js">
398 - <p><?php _e('Add or remove tags'); ?></p>
399 - <textarea name="tax_input[post_tag]" class="the-tags" id="tax-input[post_tag]"><?php echo implode(",", $tags); ?></textarea>
400 - </div>
401 -
402 - <span class="ajaxtag hide-if-no-js">
403 - <label class="screen-reader-text" for="new-tag-post_tag"><?php _e('Tags'); ?></label>
404 - <input type="text" id="new-tag-post_tag" name="newtag[post_tag]" class="newtag form-input-tip" size="16" autocomplete="off" value="<?php esc_attr_e('Add new tag'); ?>" />
405 - <input type="button" class="button tagadd" value="<?php esc_attr_e('Add'); ?>" />
406 - </span>
407 - </div>
408 - <p class="howto"><?php echo __('Separate tags with commas.'); ?></p>
409 - <div class="tagchecklist"></div>
410 - </div>
411 - <p class="tagcloud-link hide-if-no-js"><a href="#titlediv" class="tagcloud-link" id="link-post_tag"><?php printf( __('Choose from the most used tags in %s'), 'Post Tags'); ?></a></p>
412 - </div>
413 - </div>
414 -<?php
415 - else :
416 -?>
417 - <?php print $desc; ?>
418 - <p id="jaxtag"><input type="text" name="tags_input" class="tags-input" id="tags-input" size="40" tabindex="3" value="<?php echo implode(",", $tags); ?>" /></p>
419 - <div id="tagchecklist"></div>
420 - </div>
421 - </div>
422 -<?php
278 + if ( strlen( $prefix ) === 0 ) :
279 + $prefix = 'feedwordpress';
423 280 endif;
424 -}
425 281
426 -function fwp_category_box ($checked, $object, $tags = array()) {
427 - global $wp_db_version;
282 + $id_prefix = $prefix . '-';
283 + $id_suffix = '-' . $prefix;
284 + $name_prefix = $prefix . '_';
428 285
429 - if (fwp_test_wp_version(FWP_SCHEMA_25)) : // WordPress 2.5.x
430 -?>
431 -<div id="category-adder" class="wp-hidden-children">
432 - <h4><a id="category-add-toggle" href="#category-add" class="hide-if-no-js" tabindex="3"><?php _e( '+ Add New Category' ); ?></a></h4>
433 - <p id="category-add" class="wp-hidden-child">
434 - <input type="text" name="newcat" id="newcat" class="form-required form-input-tip" value="<?php _e( 'New category name' ); ?>" tabindex="3" />
435 - <?php wp_dropdown_categories( array( 'hide_empty' => 0, 'name' => 'newcat_parent', 'orderby' => 'name', 'hierarchical' => 1, 'show_option_none' => __('Parent category'), 'tab_index' => 3 ) ); ?>
436 - <input type="button" id="category-add-sumbit" class="add:categorychecklist:category-add button" value="<?php _e( 'Add' ); ?>" tabindex="3" />
437 - <?php wp_nonce_field( 'add-category', '_ajax_nonce', false ); ?>
438 - <span id="category-ajax-response"></span>
439 - </p>
286 + $box_div_id = sanitize_html_class( $id_prefix . 'taxonomy-' . $taxonomy );
287 + $tabs_ul_id = sanitize_html_class( $id_prefix . $taxonomy . '-tabs' );
288 + $all_tab_id = sanitize_html_class( $id_prefix . $taxonomy . '-all' );
289 + $chk_lst_id = sanitize_html_class( $id_prefix . $taxonomy . 'checklist' );
290 + $add_tax_id = sanitize_html_class( $id_prefix . $taxonomy . '-adder' );
291 + $add_tog_id = sanitize_html_class( $id_prefix . $taxonomy . '-add-toggle' );
292 + $add_cat_id = sanitize_html_class( $id_prefix . $taxonomy . '-add' );
293 + $new_tax_id = sanitize_html_class( $id_prefix . 'new' . $taxonomy );
294 +
295 + $tax_id_add_submit = sanitize_html_class( $id_prefix . $taxonomy . '-add-sumbit' );
296 + ?>
297 +<div id="<?php print esc_attr( $box_div_id ); ?>" class="feedwordpress-category-div">
298 + <ul id="<?php print esc_attr( $tabs_ul_id ); ?>" class="category-tabs">
299 + <li class="ui-tabs-selected tabs"><a href="#<?php print esc_attr( $all_tab_id ); ?>" tabindex="3"><?php esc_html_e( 'All posts' ); ?></a>
300 + <p style="font-size:smaller;font-style:bold;margin:0">Give <?php print esc_html( $object ); ?> these <?php print esc_html( $o_tax_labels->name ); ?></p>
301 + </li>
302 + </ul>
303 +
304 +<div id="<?php print esc_attr( $all_tab_id ); ?>" class="tabs-panel">
305 + <input type="hidden" value="0" name="tax_input[<?php print esc_attr( $taxonomy ); ?>][]" />
306 + <ul id="<?php print esc_attr( $chk_lst_id ); ?>" class="list:<?php print esc_attr( $taxonomy ); ?> categorychecklist form-no-clear">
307 + <?php fwp_category_checklist( null, false, $checked, $params ); ?>
308 + </ul>
440 309 </div>
441 310
442 -<ul id="category-tabs">
443 - <?php /* ui-tabs-selected in WP 2.7 CSS = tabs in WP 2.8 CSS. Thank you, o brilliant wordsmiths of the WordPress 2.8 stylesheet... */ ?>
444 - <li class="ui-tabs-selected tabs"><a href="#categories-all" tabindex="3"><?php _e( 'All posts' ); ?></a>
445 - <p style="font-size:smaller;font-style:bold;margin:0">Give <?php print $object; ?> these categories</p>
446 -</li>
447 -</ul>
311 +<div id="<?php print esc_attr( $add_tax_id ); ?>" class="<?php print esc_attr( $taxonomy ); ?>-adder wp-hidden-children">
312 + <h4><a id="<?php print esc_attr( $add_tog_id ); ?>" class="category-add-toggle" href="#<?php print esc_attr( $add_cat_id ); ?>" class="hide-if-no-js" tabindex="3"><?php esc_html_e( '+ Add New Category' ); ?></a></h4>.
313 + <p id="<?php print esc_attr( $add_cat_id ); ?>" class="category-add wp-hidden-child">
314 + <?php
315 + $newcat = 'new' . $taxonomy;
316 + ?>
317 + <label class="screen-reader-text" for="<?php print esc_attr( $new_tax_id ); ?>"><?php esc_html_e( 'Add New Category' ); ?></label>
318 + <input
319 + id="<?php print esc_attr( $new_tax_id ); ?>"
320 + class="<?php print esc_attr( $newcat ); ?> form-required form-input-tip"
321 + aria-required="true"
322 + tabindex="3"
323 + type="text" name="<?php print esc_attr( $newcat ); ?>"
324 + value="<?php esc_attr_e( 'New category name' ); ?>"
325 + />
326 + <label class="screen-reader-text" for="<?php print esc_attr( $new_tax_id ); ?>-parent"><?php esc_html_e( 'Parent Category:' ); ?></label>
327 + <?php
328 + wp_dropdown_categories(
329 + array(
330 + 'taxonomy' => $taxonomy,
331 + 'hide_empty' => 0,
332 + 'id' => $new_tax_id . '-parent',
333 + 'class' => $newcat . '-parent',
334 + 'name' => $newcat . '_parent',
335 + 'orderby' => 'name',
336 + 'hierarchical' => 1,
337 + 'show_option_none' => __( 'Parent category' ),
338 + 'tab_index' => 3,
339 + )
340 + );
448 341
449 -<?php /* ui-tabs-panel in WP 2.7 CSS = tabs-panel in WP 2.8 CSS. Thank you, o brilliant wordsmiths of the WordPress 2.8 stylesheet... */ ?>
450 -<div id="categories-all" class="ui-tabs-panel tabs-panel">
451 - <ul id="categorychecklist" class="list:category categorychecklist form-no-clear">
452 - <?php fwp_category_checklist(NULL, false, $checked) ?>
453 - </ul>
342 + $nonce_code = ( 'add-' . $taxonomy );
343 + ?>
344 + <input type="button" id="<?php print esc_attr( $tax_id_add_submit ); ?>" class="add:<?php print esc_attr( $id_prefix . $taxonomy ); ?>checklist:<?php print esc_attr( $id_prefix . $taxonomy ); ?>-add add-categorychecklist-category-add button category-add-submit" value="<?php esc_attr_e( 'Add' ); ?>" tabindex="3" />
345 + <?php /* wp_nonce_field currently doesn't let us set an id different from name, but we need a non-unique name and a unique id */ ?>
346 + <input type="hidden" id="_ajax_nonce<?php print esc_html( $id_suffix ); ?>" name="_ajax_nonce" value="<?php print esc_attr( wp_create_nonce( $nonce_code ) ); ?>" />
347 + <input type="hidden" id="_ajax_nonce-add-<?php print esc_attr( $taxonomy . $id_suffix ); ?>" name="_ajax_nonce-add-<?php print esc_attr( $taxonomy ); ?>" value="<?php print esc_attr( wp_create_nonce( $nonce_code ) ); ?>" />
348 + <span id="<?php print esc_attr( $id_prefix . $taxonomy ); ?>-ajax-response" class="<?php print esc_attr( $taxonomy ); ?>-ajax-response"></span>
349 + </p>
454 350 </div>
455 -<?php
456 - elseif (fwp_test_wp_version(FWP_SCHEMA_20)) : // WordPress 2.x
457 -?>
458 - <div id="moremeta" style="position: relative; right: auto">
459 - <div id="grabit" class="dbx-group">
460 - <fieldset id="categorydiv" class="dbx-box">
461 - <h3 class="dbx-handle"><?php _e('Categories') ?></h3>
462 - <div class="dbx-content">
463 - <p style="font-size:smaller;font-style:bold;margin:0">Place <?php print $object; ?> under...</p>
464 - <p id="jaxcat"></p>
465 - <div id="categorychecklist"><?php fwp_category_checklist(NULL, false, $checked); ?></div>
466 - </div>
467 - </fieldset>
468 - </div>
469 - </div>
470 -<?php
471 - else : // WordPress 1.5
472 -?>
473 - <fieldset style="width: 60%;">
474 - <legend><?php _e('Categories') ?></legend>
475 - <p style="font-size:smaller;font-style:bold;margin:0">Place <?php print $object; ?> under...</p>
476 - <div style="height: 10em; overflow: scroll;"><?php fwp_category_checklist(NULL, false, $checked); ?></div>
477 - </fieldset>
478 -<?php
479 - endif;
351 +
352 +</div>
353 + <?php
480 354 }
481 355
482 -function update_feeds_mention ($feed) {
483 - echo "<li>Updating <cite>".$feed['link/name']."</cite> from &lt;<a href=\""
484 - .$feed['link/uri']."\">".$feed['link/uri']."</a>&gt; ...";
356 +/**
357 + * Outputs a text/html status message indicating that FWP has started polling a feed.
358 + *
359 + * @param array $feed An associative array containing meta-data about the feed being polled.
360 + */
361 +function update_feeds_mention( $feed ) {
362 + printf(
363 + '<li>Updating <cite>%s</cite> from &lt;<a href="%s">%s</a>&gt; ...',
364 + esc_html( $feed['link/name'] ),
365 + esc_url( $feed['link/uri'] ),
366 + esc_html( $feed['link/uri'] )
367 + );
485 368 flush();
486 369 }
487 -function update_feeds_finish ($feed, $added, $dt) {
488 - echo " completed in $dt second".(($dt==1)?'':'s')."</li>\n";
370 +
371 +/**
372 + * Outputs a text/html status message indicating that FWP has completed polling a feed.
373 + *
374 + * @param array $feed An associative array containing meta-data about the feed being polled.
375 + * @param mixed $added a WP_Error object with error codes and messages, if there was an error in polling.
376 + * @param int $dt seconds it took to complete the poll.
377 + */
378 +function update_feeds_finish( $feed, $added, $dt ) {
379 + if ( is_wp_error( $added ) ) :
380 + $mesgs = $added->get_error_messages();
381 + foreach ( $mesgs as $mesg ) :
382 + printf( '<br/><strong>Feed error:</strong> <code>%s</code>', esc_html( $mesg ) );
383 + endforeach;
384 + echo "</li>\n";
385 + else :
386 + printf( " completed in %d second%s</li>\n", esc_html( $dt ), esc_html( _s( $dt ) ) );
387 + endif;
388 + flush();
489 389 }
490 390
491 -function fwp_author_list () {
391 +/**
392 + * Retrieves a list of users via the WordPress API.
393 + *
394 + * @return array List of users, by numeric ID => display_name
395 + */
396 +function fwp_author_list() {
492 397 global $wpdb;
493 398 $ret = array();
494 399
495 - // display_name introduced in WP 2.0
496 - if (fwp_test_wp_version(FWP_SCHEMA_20)) :
497 - $name_column = 'display_name';
498 - else :
499 - $name_column = 'user_nickname';
500 - endif;
400 + $users = get_users();
401 + if ( is_array( $users ) ) :
402 + foreach ( $users as $user ) :
403 + $id = (int) $user->ID;
404 + $ret[ $id ] = $user->display_name;
501 405
502 - $users = $wpdb->get_results("SELECT * FROM $wpdb->users ORDER BY {$name_column}");
503 - if (is_array($users)) :
504 - foreach ($users as $user) :
505 - $id = (int) $user->ID;
506 - $ret[$id] = $user->{$name_column};
507 - if (strlen(trim($ret[$id])) == 0) :
508 - $ret[$id] = $user->user_login;
406 + if ( strlen( trim( $ret[ $id ] ) ) === 0 ) :
407 + $ret[ $id ] = $user->user_login;
509 408 endif;
510 409 endforeach;
511 410 endif;
512 411 return $ret;
@@ -511,272 +410,337 @@
511 410 endif;
512 411 return $ret;
513 412 }
514 413
515 -class FeedWordPressSettingsUI {
516 - function instead_of_posts_box ($link_id = null) {
517 - if (!is_null($link_id)) :
518 - $from_this_feed = 'from this feed';
519 - $by_default = '';
520 - $id_param = "&amp;link_id=".$link_id;
521 - else :
522 - $from_this_feed = 'from syndicated feeds';
523 - $by_default = " by default";
524 - $id_param = "";
414 +/**
415 + * Insert a new user into the WordPress database, with some FeedWordPress-specific default behaviors.
416 + *
417 + * @param string $newuser_name The "Display Name" for the new user; user logins and the like will be determined by a formula.
418 + * @return mixed Either a numeric ID or a WP_Error object.
419 + */
420 +function fwp_insert_new_user( $newuser_name ) {
421 + global $wpdb;
422 +
423 + $ret = null;
424 + if ( strlen( $newuser_name ) > 0 ) :
425 + $userdata = array();
426 + $userdata['ID'] = null;
427 + $userdata['user_login'] = apply_filters( 'pre_user_login', sanitize_user( $newuser_name ) );
428 + $userdata['user_nicename'] = apply_filters( 'pre_user_nicename', sanitize_title( $newuser_name ) );
429 + $userdata['display_name'] = $newuser_name;
430 + $userdata['user_pass'] = substr( md5( uniqid( microtime() ) ), 0, 6 ); // just something random to lock it up.
431 +
432 + $blah_url = get_bloginfo( 'url' );
433 + $url = wp_parse_url( $blah_url );
434 +
435 + $userdata['user_email'] = substr( md5( uniqid( microtime() ) ), 0, 6 ) . '@' . $url['host'];
436 +
437 + $newuser_id = wp_insert_user( $userdata );
438 +
439 + $ret = $newuser_id; // Either a numeric ID or a WP_Error object.
440 +
441 + else :
442 +
443 + $ret = new WP_Error( 'empty_username', 'Provide a non-empty string for the Display Name to fwp_insert_new_user' );
444 +
445 + endif;
446 + return $ret;
447 +} /* fwp_insert_new_user ( ) */
448 +
449 +/**
450 + * Output HTML for table row in FeedWordPress Syndicated Sources list.
451 + *
452 + * @param array $links array of WordPress link objects.
453 + * @param object $page FeedWordPress admin page object.
454 + * @param string $visible 'Y' or 'N', whether to display syndicated sources marked as visible or as hidden.
455 + */
456 +function fwp_syndication_manage_page_links_table_rows( $links, $page, $visible = 'Y' ) {
457 +
458 + $fwp_syndicated_sources_columns = array( __( 'Name' ), __( 'Feed' ), __( 'Updated' ) );
459 +
460 + $subscribed = ( 'Y' === strtoupper( $visible ) );
461 + if ( $subscribed || ( count( $links ) > 0 ) ) :
462 + $table_classes = array( 'widefat' );
463 + if ( ! $subscribed ) :
464 + $table_classes[] = 'unsubscribed';
525 465 endif;
526 -?>
527 -<p>Use the <a href="admin.php?page=<?php print $GLOBALS['fwp_path'] ?>/posts-page.php<?php print $id_param; ?>"><?php _e('Posts & Links'); ?></a>
528 -settings page to set up how new posts <?php print $from_this_feed; ?> will be published<?php $by_default; ?>, whether they will accept
529 -comments and pings, any custom fields that should be set on each post, etc.</p>
530 -<?php
531 - } /* FeedWordPressSettingsUI::instead_of_posts_box () */
532 -
533 - function instead_of_authors_box ($link_id = null) {
534 - if (!is_null($link_id)) :
535 - $from_this_feed = 'from this feed';
536 - $by_default = '';
537 - $id_param = "&amp;link_id=".$link_id;
466 + $table_classes = implode( ' ', $table_classes );
467 + ?>
468 + <table class="<?php print esc_attr( $table_classes ); ?>">
469 + <thead>
470 + <tr>
471 + <th class="check-column" scope="col"><input type="checkbox" /></th>
472 + <?php
473 + foreach ( $fwp_syndicated_sources_columns as $col ) :
474 + printf( "\t<th scope='col'>%s</th>\n", esc_html( $col ) );
475 + endforeach;
476 + print "</tr>\n";
477 + print "</thead>\n";
478 + print "\n";
479 + print "<tbody>\n";
480 +
481 + $alt_row = true;
482 + if ( count( $links ) > 0 ) :
483 + foreach ( $links as $link ) :
484 + $tr_class = array();
485 +
486 + $o_s_link = new SyndicatedLink( $link->link_id );
487 +
488 + if ( is_null( $o_s_link->setting( 'update/error' ) ) ) :
489 +
490 + $the_error = null;
491 +
492 + else :
493 + $tr_class[] = 'feed-error';
494 + $the_error = unserialize( $o_s_link->setting( 'update/error' ) );
495 + endif;
496 +
497 + $ttl = $o_s_link->setting( 'update/ttl' );
498 +
499 + $alt_row = ! $alt_row;
500 +
501 + if ( $alt_row ) :
502 + $tr_class[] = 'alternate';
503 + endif;
504 + ?>
505 + <tr<?php fwp_form_class_attr( implode( ' ', $tr_class ) ); ?>>
506 + <th class="check-column" scope="row"><input type="checkbox" name="link_ids[]" value="<?php echo esc_attr( $link->link_id ); ?>" /></th>
507 + <?php
508 + $caption = (
509 + ( strlen( $link->link_rss ) > 0 )
510 + ? __( 'Switch Feed' )
511 + : __( 'Find Feed' )
512 + );
513 + ?>
514 + <td>
515 + <strong><a href="<?php print esc_url( $page->admin_page_href( 'feeds-page.php', array(), $link ) ); ?>"><?php print esc_html( $link->link_name ); ?></a></strong>
516 + <div class="row-actions">
517 + <?php
518 + if ( $subscribed ) :
519 + $page->display_feed_settings_page_links(
520 + array(
521 + 'before' => '<div><strong>Settings &gt;</strong> ',
522 + 'after' => '</div>',
523 + 'subscription' => $link,
524 + )
525 + );
526 + endif;
527 + ?>
528 +
529 + <div><strong>Actions &gt;</strong>
530 + <?php if ( $subscribed ) : ?>
531 + <a href="<?php print esc_url( $page->admin_page_href( 'syndication.php', array( 'action' => 'feedfinder' ), $link ) ); ?>"><?php echo esc_html( $caption ); ?></a>
532 + <?php else : ?>
533 + <a href="<?php print esc_url( $page->admin_page_href( 'syndication.php', array( 'action' => FWP_RESUB_CHECKED ), $link ) ); ?>"><?php esc_html_e( 'Re-subscribe' ); ?></a>
534 + <?php endif; ?>
535 + | <a href="<?php print esc_url( $page->admin_page_href( 'syndication.php', array( 'action' => 'Unsubscribe' ), $link ) ); ?>">
536 + <?php
537 + if ( $subscribed ) :
538 + esc_html_e( 'Unsubscribe' );
539 + else :
540 + esc_html_e( 'Delete permanently' );
541 + endif;
542 + ?>
543 + </a>
544 + | <a href="<?php print esc_url( $link->link_url ); ?>"><?php esc_html_e( 'View' ); ?></a></div>
545 + </div>
546 + </td>
547 + <?php if ( strlen( $link->link_rss ) > 0 ) : ?>
548 + <td><div><a href="<?php echo esc_html( $link->link_rss ); ?>"><?php echo esc_html( feedwordpress_display_url( $link->link_rss, 32 ) ); ?></a></div></td>
549 + <?php else : ?>
550 + <td class="feed-missing"><p><strong>no feed assigned</strong></p></td>
551 + <?php endif; ?>
552 +
553 + <td><div style="float: right; padding-left: 10px">
554 + <input type="submit" class="button" name="update_uri[<?php print esc_html( $link->link_rss ); ?>]" value="<?php esc_html_e( 'Update Now' ); ?>" />
555 + </div>
556 + <?php
557 + fwp_links_table_rows_last_updated( $o_s_link );
558 + fwp_links_table_rows_file_size( $o_s_link );
559 + fwp_links_table_rows_errors_since( $the_error );
560 + fwp_links_table_rows_next_update( $o_s_link );
561 + ?>
562 + </td>
563 + </tr>
564 + <?php
565 + unset( $o_s_link );
566 +
567 + endforeach;
538 568 else :
539 - $from_this_feed = 'from syndicated feeds';
540 - $by_default = " by default";
541 - $id_param = "";
569 + ?>
570 +<tr><td colspan="4"><p>There are no websites currently listed for syndication.</p></td></tr>
571 + <?php
572 +
542 573 endif;
543 574
544 -?>
545 -<p>Use the <a
546 -href="admin.php?page=<?php print $GLOBALS['fwp_path']
547 -?>/authors-page.php<?php print $id_param; ?>"><?php _e('Authors');
548 -?></a> settings page to set up how new posts
549 -<?php print $from_this_feed; ?> will be assigned to
550 -authors.</p>
551 -<?php
552 - } /* FeedWordPressSettingsUI::instead_of_authors_box () */
553 -
554 - function instead_of_categories_box ($link_id = null) {
555 - if (!is_null($link_id)) :
556 - $from_this_feed = 'from this feed';
557 - $by_default = '';
558 - $id_param = "&amp;link_id=".$link_id;
559 - else :
560 - $from_this_feed = 'from syndicated feeds';
561 - $by_default = " by default";
562 - $id_param = "";
563 - endif;
564 -
565 -?>
566 -<p>Use the <a href="admin.php?page=<?php print $GLOBALS['fwp_path'] ?>/categories-page.php<?php print $id_param; ?>"><?php _e('Categories'.FEEDWORDPRESS_AND_TAGS); ?></a>
567 -settings page to set up how new posts <?php print $from_this_feed; ?> are assigned categories <?php if (FeedWordPressCompatibility::post_tags()) : ?>or tags<?php endif; ?><?php print $by_default; ?>.</p>
568 -<?php
569 - } /* FeedWordPressSettingsUI::instead_of_categories_box () */
575 + ?>
570 576
571 - /*static*/ function ajax_nonce_fields () {
572 - if (function_exists('wp_nonce_field')) :
573 - echo "<form style='display: none' method='get' action=''>\n<p>\n";
574 - wp_nonce_field( 'closedpostboxes', 'closedpostboxesnonce', false );
575 - wp_nonce_field( 'meta-box-order', 'meta-box-order-nonce', false );
576 - echo "</p>\n</form>\n";
577 - endif;
578 - } /* FeedWordPressSettingsUI::ajax_nonce_fields () */
577 +</tbody>
578 +</table>
579 579
580 - /*static*/ function fix_toggles_js ($context) {
581 - ?>
582 - <script type="text/javascript">
583 - jQuery(document).ready( function($) {
584 - <?php if (FeedWordPressCompatibility::test_version(FWP_SCHEMA_25, FWP_SCHEMA_27)) : ?>
585 - // In case someone got here first...
586 - jQuery('.postbox h3').unbind('click');
580 + <?php
587 581
588 - add_postbox_toggles('<?php print $context; ?>');
589 - <?php elseif (FeedWordPressCompatibility::test_version(FWP_SCHEMA_27)) : ?>
590 - // In case someone got here first...
591 - $('.postbox h3, .postbox .handlediv').unbind('click');
592 - $('.postbox h3 a').unbind('click');
593 - $('.hide-postbox-tog').unbind('click');
594 - $('.columns-prefs input[type="radio"]').unbind('click');
595 - $('.meta-box-sortables').sortable('destroy');
596 -
597 - postboxes.add_postbox_toggles('<?php print $context; ?>');
598 - <?php endif; ?>
599 - } );
600 - </script>
601 - <?php
602 - } /* FeedWordPressSettingsUI::fix_toggles_js () */
603 -
604 - function magic_input_tip_js ($id) {
605 - if (FeedWordPressCompatibility::test_version(FWP_SCHEMA_25)) :
582 + endif;
583 +} /* function fwp_syndication_manage_page_links_table_rows ( ) */
584 +
585 +/**
586 + * Output HTML message indicating feed errors, if a feed has been returning errors, in Syndicated Sites table.
587 + *
588 + * @param mixed $the_error If last poll on this feed was successful, this is null.
589 + * If last poll returned an error, contains an array with 'since' (timestamp of first time an error was an encountered), 'ts' (timestamp of most recent time an error was encountered), and 'object' (a WP_Error object representing the most recent error when you polled the feed).
590 + */
591 +function fwp_links_table_rows_errors_since( $the_error ) {
592 + if ( ! is_null( $the_error ) ) :
593 +
594 + $s_elapsed = fwp_time_elapsed( $the_error['since'] );
595 + $s_recent = fwp_time_elapsed( $the_error['ts'] );
606 596 ?>
607 - <script type="text/javascript">
608 - jQuery(document).ready( function () {
609 - var inputBox = jQuery("#<?php print $id; ?>");
610 - var boxEl = inputBox.get(0);
611 - if (boxEl.value==boxEl.defaultValue) { inputBox.addClass('form-input-tip'); }
612 - inputBox.focus(function() {
613 - if ( this.value == this.defaultValue )
614 - jQuery(this).val( '' ).removeClass( 'form-input-tip' );
615 - });
616 - inputBox.blur(function() {
617 - if ( this.value == '' )
618 - jQuery(this).val( this.defaultValue ).addClass( 'form-input-tip' );
619 - });
620 - } );
621 - </script>
597 +
598 +<div class="returning-errors"><p><strong>Returning errors</strong> since <?php print esc_html( $s_elapsed ); ?></p>
599 +<p>Most recent (<?php print esc_html( $s_recent ); ?>):
622 600 <?php
601 + foreach ( $the_error['object']->get_error_messages() as $mesg ) :
602 + printf( '<br/><code>%s</code>', esc_html( $mesg ) );
603 + endforeach;
604 + ?>
605 +</p>
606 +</div>
607 +
608 + <?php
609 + endif;
610 +}
611 +
612 +/**
613 + * Output the "Last checked..." status message in Syndicated Sites table.
614 + *
615 + * @param SyndicatedLink $o_s_link The SyndicatedLink object representing the feed displayed on this row.
616 + */
617 +function fwp_links_table_rows_last_updated( $o_s_link ) {
618 + if ( ! is_null( $o_s_link->setting( 'update/last' ) ) ) :
619 + print esc_html( 'Last checked ' . fwp_time_elapsed( $o_s_link->setting( 'update/last' ) ) );
620 + else :
621 + esc_html_e( 'None yet' );
622 + endif;
623 +
624 + $ttl = $o_s_link->setting( 'update/ttl' );
625 + if ( is_numeric( $ttl ) ) :
626 + $next = $o_s_link->setting( 'update/last' ) + $o_s_link->setting( 'update/fudge' ) + ( (int) $ttl * 60 );
627 +
628 + if ( 'automatically' !== $o_s_link->setting( 'update/timed' ) ) :
629 +
630 + print ' &middot; Next ';
631 + print esc_html( fwp_relative_time_string( $next ) );
632 +
623 633 endif;
624 - } /* FeedWordPressSettingsUI::magic_input_tip_js () */
625 -} /* class FeedWordPressSettingsUI */
634 + endif;
626 635
627 -function fwp_insert_new_user ($newuser_name) {
628 - global $wpdb;
636 +}
629 637
630 - $ret = null;
631 - if (strlen($newuser_name) > 0) :
632 - $userdata = array();
633 - $userdata['ID'] = NULL;
634 -
635 - $userdata['user_login'] = sanitize_user($newuser_name);
636 - $userdata['user_login'] = apply_filters('pre_user_login', $userdata['user_login']);
637 -
638 - $userdata['user_nicename'] = sanitize_title($newuser_name);
639 - $userdata['user_nicename'] = apply_filters('pre_user_nicename', $userdata['user_nicename']);
640 -
641 - $userdata['display_name'] = $wpdb->escape($newuser_name);
638 +/**
639 + * Return a status message indicating when a feed will next be polled, based on a next-update timestamp.
640 + *
641 + * @param int $ts Timestamp for next updrate.
642 + * @param bool $ago Display "[relative time] ago", or "ASAP", if the timestamp is in the past.
643 + */
644 +function fwp_relative_time_string( $ts, $ago = false ) {
642 645
643 - $newuser_id = wp_insert_user($userdata);
644 - if (is_numeric($newuser_id)) :
645 - $ret = $newuser_id;
646 - else :
647 - // TODO: Add some error detection and reporting
648 - endif;
646 + $dt = ( $ts - time() );
647 +
648 + if ( $dt < 0 && ! $ago ) :
649 + $ret = 'ASAP';
650 + elseif ( $dt < 60 * 60 ) :
651 + $ret = fwp_time_elapsed( $ts );
652 + elseif ( $dt < 60 * 60 * 24 ) :
653 + $ret = wp_date( 'g:ia', $ts );
649 654 else :
650 - // TODO: Add some error reporting
655 + $ret = wp_date( 'F j', $ts );
651 656 endif;
652 657 return $ret;
653 -} /* fwp_insert_new_user () */
658 +}
654 659
655 -function fwp_add_meta_box ($id, $title, $callback, $page, $context = 'advanced', $priority = 'default', $callback_args = null) {
656 - if (function_exists('add_meta_box')) :
657 - return add_meta_box($id, $title, $callback, $page, $context, $priority, $callback_args);
658 - else :
659 - /* Re-used as per terms of the GPL from add_meta_box() in WordPress 2.8.1 wp-admin/includes/template.php. */
660 - global $wp_meta_boxes;
661 -
662 - if ( !isset($wp_meta_boxes) )
663 - $wp_meta_boxes = array();
664 - if ( !isset($wp_meta_boxes[$page]) )
665 - $wp_meta_boxes[$page] = array();
666 - if ( !isset($wp_meta_boxes[$page][$context]) )
667 - $wp_meta_boxes[$page][$context] = array();
668 -
669 - foreach ( array_keys($wp_meta_boxes[$page]) as $a_context ) {
670 - foreach ( array('high', 'core', 'default', 'low') as $a_priority ) {
671 - if ( !isset($wp_meta_boxes[$page][$a_context][$a_priority][$id]) )
672 - continue;
673 -
674 - // If a core box was previously added or removed by a plugin, don't add.
675 - if ( 'core' == $priority ) {
676 - // If core box previously deleted, don't add
677 - if ( false === $wp_meta_boxes[$page][$a_context][$a_priority][$id] )
678 - return;
679 - // If box was added with default priority, give it core priority to maintain sort order
680 - if ( 'default' == $a_priority ) {
681 - $wp_meta_boxes[$page][$a_context]['core'][$id] = $wp_meta_boxes[$page][$a_context]['default'][$id];
682 - unset($wp_meta_boxes[$page][$a_context]['default'][$id]);
683 - }
684 - return;
685 - }
686 - // If no priority given and id already present, use existing priority
687 - if ( empty($priority) ) {
688 - $priority = $a_priority;
689 - // else if we're adding to the sorted priortiy, we don't know the title or callback. Glab them from the previously added context/priority.
690 - } elseif ( 'sorted' == $priority ) {
691 - $title = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['title'];
692 - $callback = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['callback'];
693 - $callback_args = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['args'];
694 - }
695 - // An id can be in only one priority and one context
696 - if ( $priority != $a_priority || $context != $a_context )
697 - unset($wp_meta_boxes[$page][$a_context][$a_priority][$id]);
698 - }
699 - }
700 -
701 - if ( empty($priority) )
702 - $priority = 'low';
703 -
704 - if ( !isset($wp_meta_boxes[$page][$context][$priority]) )
705 - $wp_meta_boxes[$page][$context][$priority] = array();
706 -
707 - $wp_meta_boxes[$page][$context][$priority][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback, 'args' => $callback_args);
660 +/**
661 + * Output the File Size / Format status message in Syndicated Sites table.
662 + *
663 + * @param SyndicatedLink $o_s_link Object representing the feed displayed on this row.
664 + */
665 +function fwp_links_table_rows_file_size( $o_s_link ) {
666 +
667 + $mesg_file_size_lines = array();
668 +
669 + $feed_type = $o_s_link->get_feed_type();
670 +
671 + if ( ! is_null( $o_s_link->setting( 'link/item count' ) ) ) :
672 + $n = $o_s_link->setting( 'link/item count' );
673 +
674 + // translators: %1$d is the item count; %2$s is the plural marker (if any) for item.
675 + $mesg_file_size_lines[] = sprintf( __( '%1$d item%2$s' ), $n, _s( $n ) ) . ', ' . $feed_type;
676 +
708 677 endif;
709 -} /* function fwp_add_meta_box () */
710 678
711 -function fwp_do_meta_boxes($page, $context, $object) {
712 - if (function_exists('do_meta_boxes')) :
713 - $ret = do_meta_boxes($page, $context, $object);
714 -
715 - // Avoid JavaScript error from WordPress 2.5 bug
716 -?>
717 - <div style="display: none">
718 - <div id="tags-input"></div> <!-- avoid JS error from WP 2.5 bug -->
719 - </div>
720 -<?php
721 - return $ret;
722 - else :
723 - /* Derived as per terms of the GPL from do_meta_boxes() in WordPress 2.8.1 wp-admin/includes/template.php. */
724 - global $wp_meta_boxes;
725 - static $already_sorted = false;
726 -
727 - //do_action('do_meta_boxes', $page, $context, $object);
728 -
729 - echo "<div id='$context-sortables' class='meta-box-sortables'>\n";
730 -
731 - $i = 0;
732 - do {
733 - if ( !isset($wp_meta_boxes) || !isset($wp_meta_boxes[$page]) || !isset($wp_meta_boxes[$page][$context]) )
734 - break;
735 -
736 - foreach ( array('high', 'sorted', 'core', 'default', 'low') as $priority ) {
737 - if ( isset($wp_meta_boxes[$page][$context][$priority]) ) {
738 - foreach ( (array) $wp_meta_boxes[$page][$context][$priority] as $box ) {
739 - if ( false == $box || ! $box['title'] )
740 - continue;
741 - $i++;
742 - fwp_option_box_opener($box['title'], $box['id'], 'postbox' /*. postbox_classes($box['id'], $page)*/);
743 - call_user_func($box['callback'], $object, $box);
744 - fwp_option_box_closer();
745 -
746 - if (is_object($object) and method_exists($object, 'interstitial')) :
747 - $object->interstitial();
748 - else :
749 - // Submit button for WP 1.5, early 2.x style
750 - fwp_settings_form_periodic_submit();
751 - endif;
752 - }
753 - }
754 - }
755 - } while(0);
756 -
757 - echo "</div>";
758 -
759 - return $i;
679 + if ( is_null( $o_s_link->setting( 'update/error' ) ) ) :
680 +
681 + if ( ! is_null( $o_s_link->setting( 'link/filesize' ) ) ) :
682 + $mesg_file_size_lines[] = size_format( $o_s_link->setting( 'link/filesize' ) ) . ' total';
683 + endif;
684 +
760 685 endif;
761 -} /* function fwp_do_meta_boxes() */
762 686
763 -function fwp_remove_meta_box($id, $page, $context) {
764 - if (function_exists('remove_meta_box')) :
765 - return remove_meta_box($id, $page, $context);
766 - else :
767 - /* Re-used as per terms of the GPL from remove_meta_box() in WordPress 2.8.1 wp-admin/includes/template.php */
768 - global $wp_meta_boxes;
769 -
770 - if ( !isset($wp_meta_boxes) )
771 - $wp_meta_boxes = array();
772 - if ( !isset($wp_meta_boxes[$page]) )
773 - $wp_meta_boxes[$page] = array();
774 - if ( !isset($wp_meta_boxes[$page][$context]) )
775 - $wp_meta_boxes[$page][$context] = array();
776 -
777 - foreach ( array('high', 'core', 'default', 'low') as $priority )
778 - $wp_meta_boxes[$page][$context][$priority][$id] = false;
687 + if ( count( $mesg_file_size_lines ) > 0 ) :
688 +
689 + print '<div>';
690 + $sep = '';
691 + foreach ( $mesg_file_size_lines as $line ) :
692 + print esc_html( $sep );
693 + print esc_html( $line );
694 + $sep = ' / ';
695 + endforeach;
696 + print '</div>';
697 +
779 698 endif;
780 -} /* function fwp_remove_meta_box() */
781 699
700 +}
782 701
702 +/**
703 + * Output the Scheduled For Next Update status message in Syndicated Sites table.
704 + *
705 + * @param SyndicatedLink $o_s_link Object representing the feed displayed on this row.
706 + */
707 +function fwp_links_table_rows_next_update( $o_s_link ) {
708 + $ttl = $o_s_link->setting( 'update/ttl' );
709 + ?>
710 + <div style="max-width: 30.0em; font-size: 0.9em;"><div style="font-style:italic;">
711 + <?php
712 + if ( is_numeric( $ttl ) ) :
713 + $next = $o_s_link->setting( 'update/last' ) + $o_s_link->setting( 'update/fudge' ) + ( (int) $ttl * 60 );
714 + if ( 'automatically' === $o_s_link->setting( 'update/timed' ) ) :
715 + if ( $next < time() ) :
716 + print 'Ready and waiting to be updated since ';
717 + else :
718 + print 'Scheduled for next update ';
719 + endif;
720 +
721 + print esc_html( fwp_time_elapsed( $next ) );
722 + if ( FEEDWORDPRESS_DEBUG ) :
723 + $interval = ( ( $next - time() ) / 60 );
724 + printf( ' [%d minute%s]', intval( $interval ), esc_html( _s( $interval ) ) );
725 + endif;
726 + else :
727 + printf( '. Scheduled to be checked for updates every %d minute%s', intval( $ttl ), esc_html( _s( $ttl ) ) );
728 + ?>
729 + </div>
730 +
731 + <div style="size:0.9em; margin-top: 0.5em">This update schedule was requested by the feed provider
732 + <?php
733 + if ( $o_s_link->setting( 'update/xml' ) ) :
734 + ?>
735 + using a standard <code style="font-size: inherit; padding: 0; background: transparent">&lt;<?php print esc_html( $o_s_link->setting( 'update/xml' ) ); ?>&gt;</code> element
736 + <?php
737 + endif;
738 + endif;
739 + else :
740 + print 'Scheduled for update as soon as possible';
741 + endif;
742 + print '.';
743 + ?>
744 + </div></div>
745 + <?php
746 +}