| @@ -1,47 +1,164 @@ | ||
| 1 | 1 | <?php |
| 2 | -function fwp_linkedit_single_submit ($status = NULL) { | |
| 3 | - if (fwp_test_wp_version(FWP_SCHEMA_25, FWP_SCHEMA_27)) : | |
| 4 | -?> | |
| 5 | -<div class="submitbox" id="submitlink"> | |
| 6 | -<div id="previewview"></div> | |
| 7 | -<div class="inside"></div> | |
| 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 | -<p class="submit"> | |
| 10 | -<input type="submit" name="submit" value="<?php _e('Save') ?>" /> | |
| 11 | -</p> | |
| 12 | -</div> | |
| 13 | -<?php | |
| 17 | +$dir = dirname( __FILE__ ); | |
| 18 | +require_once "{$dir}/feedwordpressadminpage.class.php"; | |
| 19 | +require_once "{$dir}/feedwordpresssettingsui.class.php"; | |
| 20 | + | |
| 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 = '' ) { | |
| 32 | + | |
| 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 ) ); | |
| 37 | + endif; | |
| 14 | 38 | endif; |
| 15 | -} | |
| 16 | 39 | |
| 17 | -function fwp_linkedit_periodic_submit ($caption = NULL) { | |
| 18 | - if (!fwp_test_wp_version(FWP_SCHEMA_25)) : | |
| 19 | - if (is_null($caption)) : $caption = __('Save Changes »'); endif; | |
| 20 | -?> | |
| 21 | -<p class="submit"> | |
| 22 | -<input type="submit" name="submit" value="<?php print $caption; ?>" /> | |
| 23 | -</p> | |
| 24 | -<?php | |
| 40 | +} /* fwp_form_class_attr() */ | |
| 41 | + | |
| 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' ) { | |
| 55 | + | |
| 56 | + $is_on = false; | |
| 57 | + | |
| 58 | + $s_arg = $arg; | |
| 59 | + if ( is_array( $arg ) && ! is_null( $key ) ) : | |
| 60 | + if ( array_key_exists( $key, $arg ) ) : | |
| 61 | + $s_arg = $arg[ $key ]; | |
| 62 | + else : | |
| 63 | + $s_arg = false; | |
| 64 | + endif; | |
| 25 | 65 | endif; |
| 26 | -} | |
| 27 | 66 | |
| 28 | -function fwp_linkedit_single_submit_closer ($caption = NULL) { | |
| 29 | - if (fwp_test_wp_version(FWP_SCHEMA_27)) : | |
| 30 | - if (is_null($caption)) : $caption = __('Save Changes'); endif; | |
| 31 | -?> | |
| 32 | -<p class="submit"> | |
| 33 | -<input class="button-primary" type="submit" name="submit" value="<?php print $caption; ?>" /> | |
| 34 | -</p> | |
| 35 | -<?php | |
| 67 | + if ( is_string( $s_arg ) ) : | |
| 68 | + $is_on = ( strlen( $s_arg ) > 0 ); | |
| 69 | + else : | |
| 70 | + $is_on = (bool) ( $s_arg ); | |
| 36 | 71 | endif; |
| 37 | -} | |
| 38 | 72 | |
| 39 | -function fwp_authors_single_submit ($link = NULL) { | |
| 40 | - global $wp_db_version; | |
| 41 | - | |
| 42 | - if (fwp_test_wp_version(FWP_SCHEMA_25)) : | |
| 43 | -?> | |
| 73 | + if ( $is_on ) : | |
| 74 | + print sprintf( '%s="%s"', esc_attr( $flag ), esc_attr( $flag ) ); | |
| 75 | + endif; | |
| 76 | +} /* fwp_selected_flag() */ | |
| 77 | + | |
| 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() */ | |
| 93 | + | |
| 94 | +if ( ! function_exists( '_s' ) ) : | |
| 95 | +/** | |
| 96 | + * Retrieves a plural or singular form of a string based on the supplied number. | |
| 97 | + * | |
| 98 | + * Used when you want to use the appropriate form of a string based on whether | |
| 99 | + * a number is singular or plural. Very similar to WordPress l10n.php _n(), | |
| 100 | + * but designed for a nice short form in the | |
| 101 | + * default case (provide "s" when plural, "" otherwise). | |
| 102 | + * | |
| 103 | + * @note This function *may* have been defined elsewhere; also, consider | |
| 104 | + * using WordPress's own `_n()` function and derivatives. (gwyneth 20230920) | |
| 105 | + * | |
| 106 | + * @param int $n The counter to determine singular or plural form. | |
| 107 | + * @param string $plural The text to use if the counter is plural. | |
| 108 | + * @param string $singular The text to use if the counter is singular. | |
| 109 | + * | |
| 110 | + * @return string The text of the singular or plural form. | |
| 111 | + */ | |
| 112 | +function _s( $n = 0, $plural = 's', $singular = '' ) { | |
| 113 | + $is_singular = ( is_numeric( $n ) && intval( $n ) === 1 ); | |
| 114 | + return ( $is_singular ? $singular : $plural ); | |
| 115 | +} /* _s() */ | |
| 116 | +endif; | |
| 117 | + | |
| 118 | +/** | |
| 119 | + * Outputs a status message for the aggregate results of polling a set of feeds. | |
| 120 | + * | |
| 121 | + * This will always output the number of new syndicated posts added, even if this is 0. | |
| 122 | + * Posts updated and alternate versions stored will be added to the message iff > 0. | |
| 123 | + * | |
| 124 | + * @param array $delta Counters indicating results in "new", "updated" and "stored". | |
| 125 | + * @param string $joiner Default ';'. Delimiter used to separate messages about new, updated and stored posts. | |
| 126 | + */ | |
| 127 | +function fwp_update_set_results_message( $delta, $joiner = ';' ) { | |
| 128 | + | |
| 129 | + $mesg = array(); | |
| 130 | + | |
| 131 | + $delta = wp_parse_args( | |
| 132 | + $delta, | |
| 133 | + array( | |
| 134 | + 'new' => 0, | |
| 135 | + 'updated' => 0, | |
| 136 | + 'stored' => 0, | |
| 137 | + ) | |
| 138 | + ); | |
| 139 | + | |
| 140 | + $mesg[] = sprintf( ' %d new post%s syndicated', intval( $delta['new'] ), _s( $delta['new'], 's were', ' was' ) ); | |
| 141 | + if ( $delta['updated'] > 0 ) : | |
| 142 | + $mesg[] = sprintf( ' %d existing post%s updated', intval( $delta['updated'] ), _s( $delta['updated'], 's were', ' was' ) ); | |
| 143 | + endif; | |
| 144 | + if ( $delta['stored'] > 0 ) : | |
| 145 | + $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' ) ); | |
| 146 | + endif; | |
| 147 | + | |
| 148 | + if ( ! is_null( $joiner ) ) : | |
| 149 | + $mesg = implode( $joiner, $mesg ); | |
| 150 | + endif; | |
| 151 | + return $mesg; | |
| 152 | +} /* function fwp_update_set_results_message() */ | |
| 153 | + | |
| 154 | +/** | |
| 155 | + * Outputs the HTML template for a "Submit" button on FWP admin pages. | |
| 156 | + * | |
| 157 | + * @param mixed $link The syndicated link, if any, that we are viewing settings for. (Unused) | |
| 158 | + */ | |
| 159 | +function fwp_authors_single_submit( $link = null ) { | |
| 160 | + ?> | |
| 44 | 161 | <div class="submitbox" id="submitlink"> |
| 45 | 162 | <div id="previewview"> |
| 46 | 163 | </div> |
| 47 | 164 | <div class="inside"> |
| @@ -47,262 +164,595 @@ | ||
| 47 | 164 | <div class="inside"> |
| 48 | 165 | </div> |
| 49 | 166 | |
| 50 | 167 | <p class="submit"> |
| 51 | -<input type="submit" name="save" value="<?php _e('Save') ?>" /> | |
| 168 | +<input type="submit" name="save" value="<?php esc_html_e( 'Save' ); ?>" /> | |
| 52 | 169 | </p> |
| 53 | 170 | </div> |
| 54 | -<?php | |
| 171 | + <?php | |
| 172 | +} /* function fwp_authors_single_submit() */ | |
| 173 | + | |
| 174 | +/** | |
| 175 | + * Outputs the HTML template for a Tags (or similar taxonomy) add / remove box in FeedWordPress admin UI pages. | |
| 176 | + * | |
| 177 | + * @param array $tags An array of tags already applied to the object. | |
| 178 | + * @param string $object The human-readable description of the objects to be tagged ("post", "posts from this feed", etc.). | |
| 179 | + * @param array $params An array of optional parameters. | |
| 180 | + */ | |
| 181 | +function fwp_tags_box( $tags, $object, $params = array() ) { | |
| 182 | + $params = wp_parse_args( | |
| 183 | + $params, | |
| 184 | + array( // Default values. | |
| 185 | + 'taxonomy' => 'post_tag', | |
| 186 | + 'textarea_name' => null, | |
| 187 | + 'textarea_id' => null, | |
| 188 | + 'input_id' => null, | |
| 189 | + 'input_name' => null, | |
| 190 | + 'id' => null, | |
| 191 | + 'box_title' => __( 'Post Tags' ), | |
| 192 | + ) | |
| 193 | + ); | |
| 194 | + | |
| 195 | + if ( ! is_array( $tags ) ) : | |
| 196 | + $tags = array(); | |
| 55 | 197 | endif; |
| 56 | -} | |
| 57 | 198 | |
| 58 | -function fwp_option_box_opener ($legend, $id, $class = "stuffbox") { | |
| 59 | - global $wp_db_version; | |
| 60 | - if (isset($wp_db_version) and $wp_db_version >= FWP_SCHEMA_25) : | |
| 61 | -?> | |
| 62 | -<div id="<?php print $id; ?>" class="<?php print $class; ?>"> | |
| 63 | -<h3><?php print htmlspecialchars($legend); ?></h3> | |
| 64 | -<div class="inside"> | |
| 65 | -<?php | |
| 66 | - else : | |
| 67 | -?> | |
| 68 | -<fieldset class="options"><legend><?php print htmlspecialchars($legend); ?></legend> | |
| 69 | -<?php | |
| 199 | + $tax_name = $params['taxonomy']; | |
| 200 | + $o_tax = get_taxonomy( $params['taxonomy'] ); | |
| 201 | + $o_tax_labels = get_taxonomy_labels( $o_tax ); | |
| 202 | + $is_enabled = current_user_can( $o_tax->cap->assign_terms ); | |
| 203 | + | |
| 204 | + if ( is_null( $params['textarea_name'] ) ) : | |
| 205 | + $params['textarea_name'] = "tax_input[$tax_name]"; | |
| 70 | 206 | endif; |
| 207 | + if ( is_null( $params['textarea_id'] ) ) : | |
| 208 | + $params['textarea_id'] = "tax-input-{$tax_name}"; | |
| 209 | + endif; | |
| 210 | + if ( is_null( $params['input_id'] ) ) : | |
| 211 | + $params['input_id'] = "new-tag-{$tax_name}"; | |
| 212 | + endif; | |
| 213 | + if ( is_null( $params['input_name'] ) ) : | |
| 214 | + $params['input_name'] = "newtag[$tax_name]"; | |
| 215 | + endif; | |
| 216 | + if ( is_null( $params['id'] ) ) : | |
| 217 | + $params['id'] = $tax_name; | |
| 218 | + endif; | |
| 219 | + | |
| 220 | + printf( /* $desc = */ '<p style="font-size:smaller;font-style:bold;margin:0\">' . esc_html__( 'Tag' ) . ' %s ' | |
| 221 | + . esc_html__( 'as' ) . '...</p>', esc_html( $object ) ); | |
| 222 | + $helps = __( 'Separate tags with commas.' ); | |
| 223 | + $box['title'] = __( 'Tags' ); | |
| 224 | + ?> | |
| 225 | +<div class="tagsdiv" id="<?php echo esc_attr( $params['id'] ); ?>"> | |
| 226 | + <div class="jaxtag"> | |
| 227 | + <div class="nojs-tags hide-if-js"> | |
| 228 | + <p><?php echo esc_html( $o_tax_labels->add_or_remove_items ); ?></p> | |
| 229 | + <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> | |
| 230 | + | |
| 231 | + <?php if ( $is_enabled ) : ?> | |
| 232 | + <div class="ajaxtag hide-if-no-js"> | |
| 233 | + <label class="screen-reader-text" for="<?php echo esc_attr( $params['input_id'] ); ?>"><?php echo esc_html( $params['box_title'] ); ?></label> | |
| 234 | + <div class="taghint"><?php echo esc_html( $o_tax_labels->add_new_item ); ?></div> | |
| 235 | + <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="" /> | |
| 236 | + <input type="button" class="button tagadd" value="<?php esc_attr_e( 'Add' ); ?>" tabindex="3" /></p> | |
| 237 | + </div> | |
| 238 | + <p class="howto"><?php echo esc_attr( $o_tax_labels->separate_items_with_commas ); ?></p> | |
| 239 | + <?php endif; ?> | |
| 240 | + </div> | |
| 241 | + | |
| 242 | + <div class="tagchecklist"></div> | |
| 243 | +</div> | |
| 244 | + <?php | |
| 245 | + if ( $is_enabled ) : | |
| 246 | + ?> | |
| 247 | +<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> | |
| 248 | + <?php | |
| 249 | + endif; | |
| 250 | + | |
| 71 | 251 | } |
| 72 | 252 | |
| 73 | -function fwp_option_box_closer () { | |
| 74 | - global $wp_db_version; | |
| 75 | - if (isset($wp_db_version) and $wp_db_version >= FWP_SCHEMA_25) : | |
| 76 | -?> | |
| 77 | - </div> <!-- class="inside" --> | |
| 78 | - </div> <!-- class="stuffbox" --> | |
| 79 | -<?php | |
| 80 | - else : | |
| 81 | -?> | |
| 82 | -</fieldset> | |
| 83 | -<?php | |
| 253 | +/** | |
| 254 | + * Outputs the HTML template for a Category (or similar taxonomy) add / remove box in FeedWordPress admin UI pages. | |
| 255 | + * | |
| 256 | + * @param array $checked An array of cats already applied to the object. | |
| 257 | + * @param string $object The human-readable description of the objects to be tagged ("post", "posts from this feed", etc.). | |
| 258 | + * @param array $tags Not used. | |
| 259 | + * @param array $params An array of optional parameters (to be parsed with wp_parse_args). | |
| 260 | + * | |
| 261 | + * @uses wp_parse_args() | |
| 262 | + * @uses get_taxonomy() | |
| 263 | + * @uses get_taxonomy_labels() | |
| 264 | + */ | |
| 265 | +function fwp_category_box( $checked, $object, $tags = array(), $params = array() ) { | |
| 266 | + if ( is_string( $params ) ) : | |
| 267 | + $prefix = $params; | |
| 268 | + $taxonomy = 'category'; | |
| 269 | + elseif ( is_array( $params ) ) : | |
| 270 | + $params = wp_parse_args( | |
| 271 | + $params, | |
| 272 | + array( | |
| 273 | + 'prefix' => '', | |
| 274 | + 'taxonomy' => 'category', | |
| 275 | + ) | |
| 276 | + ); | |
| 277 | + | |
| 278 | + $prefix = $params['prefix']; | |
| 279 | + $taxonomy = $params['taxonomy']; | |
| 84 | 280 | endif; |
| 85 | -} | |
| 86 | 281 | |
| 87 | -function fwp_tags_box ($tags, $object) { | |
| 88 | - if (!is_array($tags)) : $tags = array(); endif; | |
| 89 | - | |
| 90 | - $desc = "<p style=\"font-size:smaller;font-style:bold;margin:0\">Tag $object as...</p>"; | |
| 282 | + $o_tax = get_taxonomy( $taxonomy ); | |
| 283 | + $o_tax_labels = get_taxonomy_labels( $o_tax ); | |
| 91 | 284 | |
| 92 | - if (fwp_test_wp_version(FWP_SCHEMA_28)) : // WordPress 2.8+ | |
| 93 | - fwp_option_box_opener(__('Tags'), 'tagsdiv', 'postbox'); | |
| 94 | -?> | |
| 95 | - <?php print $desc; ?> | |
| 96 | - <div class="tagsdiv" id="post_tag"> | |
| 97 | - <div class="jaxtag"> | |
| 98 | - <div class="nojs-tags hide-if-js"> | |
| 99 | - <p><?php _e('Add or remove tags'); ?></p> | |
| 100 | - <textarea name="tax_input[post_tag]" class="the-tags" id="tax-input[post_tag]"><?php echo implode(",", $tags); ?></textarea> | |
| 101 | - </div> | |
| 102 | - | |
| 103 | - <span class="ajaxtag hide-if-no-js"> | |
| 104 | - <label class="screen-reader-text" for="new-tag-post_tag"><?php _e('Tags'); ?></label> | |
| 105 | - <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'); ?>" /> | |
| 106 | - <input type="button" class="button tagadd" value="<?php esc_attr_e('Add'); ?>" /> | |
| 107 | - </span> | |
| 108 | - </div> | |
| 109 | - <p class="howto"><?php echo __('Separate tags with commas.'); ?></p> | |
| 110 | - <div class="tagchecklist"></div> | |
| 111 | - </div> | |
| 112 | - <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> | |
| 113 | - </div> | |
| 114 | - </div> | |
| 115 | -<?php | |
| 116 | - else : | |
| 117 | - fwp_option_box_opener(__('Tags'), 'tagsdiv', 'postbox'); | |
| 118 | -?> | |
| 119 | - <?php print $desc; ?> | |
| 120 | - <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> | |
| 121 | - <div id="tagchecklist"></div> | |
| 122 | - </div> | |
| 123 | - </div> | |
| 124 | -<?php | |
| 285 | + if ( strlen( $prefix ) === 0 ) : | |
| 286 | + $prefix = 'feedwordpress'; | |
| 125 | 287 | endif; |
| 126 | -} | |
| 127 | 288 | |
| 128 | -function fwp_category_box ($checked, $object, $tags = array()) { | |
| 129 | - global $wp_db_version; | |
| 289 | + $id_prefix = $prefix . '-'; | |
| 290 | + $id_suffix = '-' . $prefix; | |
| 291 | + $name_prefix = $prefix . '_'; // unused? (gwyneth 20230918) | |
| 130 | 292 | |
| 131 | - if (fwp_test_wp_version(FWP_SCHEMA_25)) : // WordPress 2.5.x | |
| 132 | -?> | |
| 133 | -<div id="category-adder" class="wp-hidden-children"> | |
| 134 | - <h4><a id="category-add-toggle" href="#category-add" class="hide-if-no-js" tabindex="3"><?php _e( '+ Add New Category' ); ?></a></h4> | |
| 135 | - <p id="category-add" class="wp-hidden-child"> | |
| 136 | - <input type="text" name="newcat" id="newcat" class="form-required form-input-tip" value="<?php _e( 'New category name' ); ?>" tabindex="3" /> | |
| 137 | - <?php wp_dropdown_categories( array( 'hide_empty' => 0, 'name' => 'newcat_parent', 'orderby' => 'name', 'hierarchical' => 1, 'show_option_none' => __('Parent category'), 'tab_index' => 3 ) ); ?> | |
| 138 | - <input type="button" id="category-add-sumbit" class="add:categorychecklist:category-add button" value="<?php _e( 'Add' ); ?>" tabindex="3" /> | |
| 139 | - <?php wp_nonce_field( 'add-category', '_ajax_nonce', false ); ?> | |
| 140 | - <span id="category-ajax-response"></span> | |
| 141 | - </p> | |
| 293 | + $box_div_id = sanitize_html_class( $id_prefix . 'taxonomy-' . $taxonomy ); | |
| 294 | + $tabs_ul_id = sanitize_html_class( $id_prefix . $taxonomy . '-tabs' ); | |
| 295 | + $all_tab_id = sanitize_html_class( $id_prefix . $taxonomy . '-all' ); | |
| 296 | + $chk_lst_id = sanitize_html_class( $id_prefix . $taxonomy . 'checklist' ); | |
| 297 | + $add_tax_id = sanitize_html_class( $id_prefix . $taxonomy . '-adder' ); | |
| 298 | + $add_tog_id = sanitize_html_class( $id_prefix . $taxonomy . '-add-toggle' ); | |
| 299 | + $add_cat_id = sanitize_html_class( $id_prefix . $taxonomy . '-add' ); | |
| 300 | + $new_tax_id = sanitize_html_class( $id_prefix . 'new' . $taxonomy ); | |
| 301 | + | |
| 302 | + $tax_id_add_submit = sanitize_html_class( $id_prefix . $taxonomy . '-add-sumbit' ); | |
| 303 | + ?> | |
| 304 | +<div id="<?php print esc_attr( $box_div_id ); ?>" class="feedwordpress-category-div"> | |
| 305 | + <ul id="<?php print esc_attr( $tabs_ul_id ); ?>" class="category-tabs"> | |
| 306 | + <li class="ui-tabs-selected tabs"><a href="#<?php print esc_attr( $all_tab_id ); ?>" tabindex="3"><?php esc_html_e( 'All posts' ); ?></a> | |
| 307 | + <p style="font-size:smaller;font-style:bold;margin:0"><?php esc_html_e( 'Give' ); ?> <?php print esc_html( $object ); ?> <?php esc_html_e( 'these' ); ?> <?php print esc_html( $o_tax_labels->name ); ?></p> | |
| 308 | + </li> | |
| 309 | + </ul> | |
| 310 | + | |
| 311 | +<div id="<?php print esc_attr( $all_tab_id ); ?>" class="tabs-panel"> | |
| 312 | + <input type="hidden" value="0" name="tax_input[<?php print esc_attr( $taxonomy ); ?>][]" /> | |
| 313 | + <ul id="<?php print esc_attr( $chk_lst_id ); ?>" class="list:<?php print esc_attr( $taxonomy ); ?> categorychecklist form-no-clear"> | |
| 314 | + <?php fwp_category_checklist( null, false, $checked, $params ); ?> | |
| 315 | + </ul> | |
| 142 | 316 | </div> |
| 143 | 317 | |
| 144 | -<ul id="category-tabs"> | |
| 145 | - <?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... */ ?> | |
| 146 | - <li class="ui-tabs-selected tabs"><a href="#categories-all" tabindex="3"><?php _e( 'All posts' ); ?></a> | |
| 147 | - <p style="font-size:smaller;font-style:bold;margin:0">Give <?php print $object; ?> these categories</p> | |
| 148 | -</li> | |
| 149 | -</ul> | |
| 318 | +<div id="<?php print esc_attr( $add_tax_id ); ?>" class="<?php print esc_attr( $taxonomy ); ?>-adder wp-hidden-children"> | |
| 319 | + <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"><span class="dashicons dashicons-plus fwp-no-underline"></span> <?php esc_html_e( 'Add New Category' ); ?></a></h4>. | |
| 320 | + <p id="<?php print esc_attr( $add_cat_id ); ?>" class="category-add wp-hidden-child"> | |
| 321 | + <?php | |
| 322 | + $newcat = 'new' . $taxonomy; | |
| 323 | + ?> | |
| 324 | + <label class="screen-reader-text" for="<?php print esc_attr( $new_tax_id ); ?>"><?php esc_html_e( 'Add New Category' ); ?></label> | |
| 325 | + <input | |
| 326 | + id="<?php print esc_attr( $new_tax_id ); ?>" | |
| 327 | + class="<?php print esc_attr( $newcat ); ?> form-required form-input-tip" | |
| 328 | + aria-required="true" | |
| 329 | + tabindex="3" | |
| 330 | + type="text" name="<?php print esc_attr( $newcat ); ?>" | |
| 331 | + value="<?php esc_attr_e( 'New category name' ); ?>" | |
| 332 | + /> | |
| 333 | + <label class="screen-reader-text" for="<?php print esc_attr( $new_tax_id ); ?>-parent"><?php esc_html_e( 'Parent Category' ); ?>:</label> | |
| 334 | + <?php | |
| 335 | + wp_dropdown_categories( | |
| 336 | + array( | |
| 337 | + 'taxonomy' => $taxonomy, | |
| 338 | + 'hide_empty' => 0, | |
| 339 | + 'id' => $new_tax_id . '-parent', | |
| 340 | + 'class' => $newcat . '-parent', | |
| 341 | + 'name' => $newcat . '_parent', | |
| 342 | + 'orderby' => 'name', | |
| 343 | + 'hierarchical' => 1, | |
| 344 | + 'show_option_none' => __( 'Parent category' ), | |
| 345 | + 'tab_index' => 3, | |
| 346 | + ) | |
| 347 | + ); | |
| 150 | 348 | |
| 151 | -<?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... */ ?> | |
| 152 | -<div id="categories-all" class="ui-tabs-panel tabs-panel"> | |
| 153 | - <ul id="categorychecklist" class="list:category categorychecklist form-no-clear"> | |
| 154 | - <?php fwp_category_checklist(NULL, false, $checked) ?> | |
| 155 | - </ul> | |
| 349 | + $nonce_code = ( 'add-' . $taxonomy ); | |
| 350 | + ?> | |
| 351 | + <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" /> | |
| 352 | + <?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 */ ?> | |
| 353 | + <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 ) ); ?>" /> | |
| 354 | + <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 ) ); ?>" /> | |
| 355 | + <span id="<?php print esc_attr( $id_prefix . $taxonomy ); ?>-ajax-response" class="<?php print esc_attr( $taxonomy ); ?>-ajax-response"></span> | |
| 356 | + </p> | |
| 156 | 357 | </div> |
| 157 | -<?php | |
| 158 | - elseif (fwp_test_wp_version(FWP_SCHEMA_20)) : // WordPress 2.x | |
| 159 | -?> | |
| 160 | - <div id="moremeta"> | |
| 161 | - <div id="grabit" class="dbx-group"> | |
| 162 | - <fieldset id="categorydiv" class="dbx-box"> | |
| 163 | - <h3 class="dbx-handle"><?php _e('Categories') ?></h3> | |
| 164 | - <div class="dbx-content"> | |
| 165 | - <p style="font-size:smaller;font-style:bold;margin:0">Place <?php print $object; ?> under...</p> | |
| 166 | - <p id="jaxcat"></p> | |
| 167 | - <div id="categorychecklist"><?php fwp_category_checklist(NULL, false, $checked); ?></div> | |
| 168 | - </div> | |
| 169 | - </fieldset> | |
| 170 | - </div> | |
| 171 | - </div> | |
| 172 | -<?php | |
| 173 | - else : // WordPress 1.5 | |
| 174 | -?> | |
| 175 | - <fieldset style="width: 60%;"> | |
| 176 | - <legend><?php _e('Categories') ?></legend> | |
| 177 | - <p style="font-size:smaller;font-style:bold;margin:0">Place <?php print $object; ?> under...</p> | |
| 178 | - <div style="height: 10em; overflow: scroll;"><?php fwp_category_checklist(NULL, false, $checked); ?></div> | |
| 179 | - </fieldset> | |
| 180 | -<?php | |
| 181 | - endif; | |
| 358 | + | |
| 359 | +</div> | |
| 360 | + <?php | |
| 182 | 361 | } |
| 183 | 362 | |
| 184 | -function update_feeds_mention ($feed) { | |
| 185 | - echo "<li>Updating <cite>".$feed['link/name']."</cite> from <<a href=\"" | |
| 186 | - .$feed['link/uri']."\">".$feed['link/uri']."</a>> ..."; | |
| 363 | +/** | |
| 364 | + * Outputs a text/html status message indicating that FWP has started polling a feed. | |
| 365 | + * | |
| 366 | + * @param array $feed An associative array containing meta-data about the feed being polled. | |
| 367 | + */ | |
| 368 | +function update_feeds_mention( $feed ) { | |
| 369 | + printf( | |
| 370 | + '<li>' . esc_html__( 'Updating' ) . ' <cite>%s</cite> ' . esc_html__( 'from' ) . ' <<a href="%s">%s</a>> ...', | |
| 371 | + esc_html( $feed['link/name'] ), | |
| 372 | + esc_url( $feed['link/uri'] ), | |
| 373 | + esc_html( $feed['link/uri'] ) | |
| 374 | + ); | |
| 187 | 375 | flush(); |
| 188 | -} | |
| 189 | -function update_feeds_finish ($feed, $added, $dt) { | |
| 190 | - echo " completed in $dt second".(($dt==1)?'':'s')."</li>\n"; | |
| 191 | -} | |
| 376 | +} /* update_feeds_mention() */ | |
| 192 | 377 | |
| 193 | -function fwp_author_list () { | |
| 194 | - global $wpdb; | |
| 378 | +/** | |
| 379 | + * Outputs a text/html status message indicating that FWP has completed polling a feed. | |
| 380 | + * | |
| 381 | + * @param array $feed An associative array containing meta-data about the feed being polled (unused). | |
| 382 | + * @param mixed $added a WP_Error object with error codes and messages, if there was an error in polling. | |
| 383 | + * @param int $dt seconds it took to complete the poll. | |
| 384 | + */ | |
| 385 | +function update_feeds_finish( $feed, $added, $dt ) { | |
| 386 | + if ( is_wp_error( $added ) ) : | |
| 387 | + $mesgs = $added->get_error_messages(); | |
| 388 | + foreach ( $mesgs as $mesg ) : | |
| 389 | + printf( '<br/><strong>%s:</strong> <code>%s</code>', esc_html__( 'Feed error' ), esc_html( $mesg ) ); | |
| 390 | + endforeach; | |
| 391 | + echo "</li>\n"; | |
| 392 | + else : | |
| 393 | + printf( esc_html__(" completed in %d second%s") . "</li>\n", esc_html( $dt ), esc_html( _s( $dt ) ) ); | |
| 394 | + endif; | |
| 395 | + flush(); | |
| 396 | +} /* update_feeds_finish() */ | |
| 397 | + | |
| 398 | +/** | |
| 399 | + * Retrieves a list of users via the WordPress API. | |
| 400 | + * | |
| 401 | + * @return array List of users, by numeric ID => display_name | |
| 402 | + */ | |
| 403 | +function fwp_author_list() { | |
| 195 | 404 | $ret = array(); |
| 196 | 405 | |
| 197 | - // display_name introduced in WP 2.0 | |
| 198 | - if (fwp_test_wp_version(FWP_SCHEMA_20)) : | |
| 199 | - $name_column = 'display_name'; | |
| 200 | - else : | |
| 201 | - $name_column = 'user_nickname'; | |
| 202 | - endif; | |
| 406 | + $users = get_users(); | |
| 407 | + if ( is_array( $users ) ) : | |
| 408 | + foreach ( $users as $user ) : | |
| 409 | + $id = (int) $user->ID; | |
| 410 | + $ret[ $id ] = $user->display_name; | |
| 203 | 411 | |
| 204 | - $users = $wpdb->get_results("SELECT * FROM $wpdb->users ORDER BY {$name_column}"); | |
| 205 | - if (is_array($users)) : | |
| 206 | - foreach ($users as $user) : | |
| 207 | - $id = (int) $user->ID; | |
| 208 | - $ret[$id] = $user->{$name_column}; | |
| 209 | - if (strlen(trim($ret[$id])) == 0) : | |
| 210 | - $ret[$id] = $user->user_login; | |
| 412 | + if ( strlen( trim( $ret[ $id ] ) ) === 0 ) : | |
| 413 | + $ret[ $id ] = $user->user_login; | |
| 211 | 414 | endif; |
| 212 | 415 | endforeach; |
| 213 | 416 | endif; |
| 214 | 417 | return $ret; |
| 215 | -} | |
| 418 | +} /* fwp_author_list() */ | |
| 216 | 419 | |
| 217 | -class FeedWordPressSettingsUI { | |
| 218 | - function instead_of_posts_box ($link_id = null) { | |
| 219 | - fwp_option_box_opener('Syndicated Posts, Comments & Pings', 'syndicatedpostsdiv', 'postbox'); | |
| 220 | - if (!is_null($link_id)) : | |
| 221 | - $from_this_feed = 'from this feed'; | |
| 222 | - $by_default = ''; | |
| 223 | - $id_param = "&link_id=".$link_id; | |
| 420 | +/** | |
| 421 | + * Insert a new user into the WordPress database, with some FeedWordPress-specific default behaviors. | |
| 422 | + * | |
| 423 | + * @param string $newuser_name The "Display Name" for the new user; user logins and the like will be determined by a formula. | |
| 424 | + * @return int|WP_Error Either a numeric ID or a WP_Error object. | |
| 425 | + */ | |
| 426 | +function fwp_insert_new_user( $newuser_name ) { | |
| 427 | + $ret = null; | |
| 428 | + if ( strlen( $newuser_name ) > 0 ) : | |
| 429 | + $userdata = array(); | |
| 430 | + $userdata['ID'] = null; | |
| 431 | + $userdata['user_login'] = apply_filters( 'pre_user_login', sanitize_user( $newuser_name ) ); | |
| 432 | + $userdata['user_nicename'] = apply_filters( 'pre_user_nicename', sanitize_title( $newuser_name ) ); | |
| 433 | + $userdata['display_name'] = $newuser_name; | |
| 434 | + $userdata['user_pass'] = substr( md5( uniqid( microtime() ) ), 0, 6 ); // just something random to lock it up. | |
| 435 | + | |
| 436 | + $blah_url = get_bloginfo( 'url' ); | |
| 437 | + $url = wp_parse_url( $blah_url ); | |
| 438 | + | |
| 439 | + $userdata['user_email'] = substr( md5( uniqid( microtime() ) ), 0, 6 ) . '@' . $url['host']; | |
| 440 | + | |
| 441 | + $newuser_id = wp_insert_user( $userdata ); | |
| 442 | + | |
| 443 | + $ret = $newuser_id; // Either a numeric ID or a WP_Error object. | |
| 444 | + | |
| 445 | + else : | |
| 446 | + | |
| 447 | + $ret = new WP_Error( 'empty_username', 'Provide a non-empty string for the Display Name to fwp_insert_new_user' ); | |
| 448 | + | |
| 449 | + endif; | |
| 450 | + return $ret; | |
| 451 | +} /* fwp_insert_new_user ( ) */ | |
| 452 | + | |
| 453 | +/** | |
| 454 | + * Output HTML for table row in FeedWordPress Syndicated Sources list. | |
| 455 | + * | |
| 456 | + * @param array $links array of WordPress link objects. | |
| 457 | + * @param object $page FeedWordPress admin page object. | |
| 458 | + * @param string $visible 'Y' or 'N', whether to display syndicated sources marked as visible or as hidden. | |
| 459 | + */ | |
| 460 | +function fwp_syndication_manage_page_links_table_rows( $links, $page, $visible = 'Y' ) { | |
| 461 | + | |
| 462 | + $fwp_syndicated_sources_columns = array( __( 'Name' ), __( 'Feed' ), __( 'Updated' ) ); | |
| 463 | + | |
| 464 | + $subscribed = ( 'Y' === strtoupper( $visible ) ); | |
| 465 | + if ( $subscribed || ( count( $links ) > 0 ) ) : | |
| 466 | + $table_classes = array( 'widefat' ); | |
| 467 | + if ( ! $subscribed ) : | |
| 468 | + $table_classes[] = 'unsubscribed'; | |
| 469 | + endif; | |
| 470 | + $table_classes = implode( ' ', $table_classes ); | |
| 471 | + ?> | |
| 472 | + <table class="<?php print esc_attr( $table_classes ); ?>"> | |
| 473 | + <thead> | |
| 474 | + <tr> | |
| 475 | + <th class="check-column" scope="col"><input type="checkbox" /></th> | |
| 476 | + <?php | |
| 477 | + foreach ( $fwp_syndicated_sources_columns as $col ) : | |
| 478 | + printf( "\t<th scope='col'>%s</th>\n", esc_html( $col ) ); | |
| 479 | + endforeach; | |
| 480 | + ?> | |
| 481 | + </tr> | |
| 482 | + </thead> | |
| 483 | + <tbody> | |
| 484 | + <?php | |
| 485 | + $alt_row = true; | |
| 486 | + if ( count( $links ) > 0 ) : | |
| 487 | + foreach ( $links as $link ) : | |
| 488 | + $tr_class = array(); | |
| 489 | + | |
| 490 | + $o_s_link = new SyndicatedLink( $link->link_id ); | |
| 491 | + | |
| 492 | + if ( is_null( $o_s_link->setting( 'update/error' ) ) ) : | |
| 493 | + | |
| 494 | + $the_error = null; | |
| 495 | + | |
| 496 | + else : | |
| 497 | + $tr_class[] = 'feed-error'; | |
| 498 | + $the_error = unserialize( $o_s_link->setting( 'update/error' ) ); | |
| 499 | + endif; | |
| 500 | + | |
| 501 | + $ttl = $o_s_link->setting( 'update/ttl' ); | |
| 502 | + | |
| 503 | + $alt_row = ! $alt_row; | |
| 504 | + | |
| 505 | + if ( $alt_row ) : | |
| 506 | + $tr_class[] = 'alternate'; | |
| 507 | + endif; | |
| 508 | + ?> | |
| 509 | + <tr<?php fwp_form_class_attr( implode( ' ', $tr_class ) ); ?>> | |
| 510 | + <th class="check-column" scope="row"><input type="checkbox" name="link_ids[]" value="<?php echo esc_attr( $link->link_id ); ?>" /></th> | |
| 511 | + <?php | |
| 512 | + $caption = ( | |
| 513 | + ( strlen( $link->link_rss ) > 0 ) | |
| 514 | + ? __( 'Switch Feed' ) | |
| 515 | + : __( 'Find Feed' ) | |
| 516 | + ); | |
| 517 | + ?> | |
| 518 | + <td> | |
| 519 | + <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> | |
| 520 | + <div class="row-actions"> | |
| 521 | + <?php | |
| 522 | + if ( $subscribed ) : | |
| 523 | + $page->display_feed_settings_page_links( | |
| 524 | + array( | |
| 525 | + 'before' => '<div><strong> ' . __( 'Settings' ) . ' ></strong> ', | |
| 526 | + 'after' => '</div>', | |
| 527 | + 'subscription' => $link, | |
| 528 | + ) | |
| 529 | + ); | |
| 530 | + endif; | |
| 531 | + ?> | |
| 532 | + | |
| 533 | + <div><strong><?php esc_html_e( 'Actions' ); ?> ></strong> | |
| 534 | + <?php if ( $subscribed ) : ?> | |
| 535 | + <a href="<?php print esc_url( $page->admin_page_href( 'syndication.php', array( 'action' => 'feedfinder' ), $link ) ); ?>"><?php echo esc_html( $caption ); ?></a> | |
| 536 | + <?php else : ?> | |
| 537 | + <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> | |
| 538 | + <?php endif; ?> | |
| 539 | + | <a href="<?php print esc_url( $page->admin_page_href( 'syndication.php', array( 'action' => 'Unsubscribe' ), $link ) ); ?>"> | |
| 540 | + <?php | |
| 541 | + if ( $subscribed ) : | |
| 542 | + esc_html_e( 'Unsubscribe' ); | |
| 543 | + else : | |
| 544 | + esc_html_e( 'Delete permanently' ); | |
| 545 | + endif; | |
| 546 | + ?> | |
| 547 | + </a> | |
| 548 | + | <a href="<?php print esc_url( $link->link_url ); ?>"><?php esc_html_e( 'View' ); ?></a></div> | |
| 549 | + </div> | |
| 550 | + </td> | |
| 551 | + <?php if ( strlen( $link->link_rss ) > 0 ) : ?> | |
| 552 | + <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> | |
| 553 | + <?php else : ?> | |
| 554 | + <td class="feed-missing"><p><strong><?php esc_html_e( 'no feed assigned' ); ?></strong></p></td> | |
| 555 | + <?php endif; ?> | |
| 556 | + | |
| 557 | + <td><div style="float: right; padding-left: 10px"> | |
| 558 | + <input type="submit" class="button" name="update_uri[<?php print esc_html( $link->link_rss ); ?>]" value="<?php esc_html_e( 'Update Now' ); ?>" /> | |
| 559 | + </div> | |
| 560 | + <?php | |
| 561 | + fwp_links_table_rows_last_updated( $o_s_link ); | |
| 562 | + fwp_links_table_rows_file_size( $o_s_link ); | |
| 563 | + fwp_links_table_rows_errors_since( $the_error ); | |
| 564 | + fwp_links_table_rows_next_update( $o_s_link ); | |
| 565 | + ?> | |
| 566 | + </td> | |
| 567 | + </tr> | |
| 568 | + <?php | |
| 569 | + unset( $o_s_link ); | |
| 570 | + | |
| 571 | + endforeach; | |
| 224 | 572 | else : |
| 225 | - $from_this_feed = 'from syndicated feeds'; | |
| 226 | - $by_default = " by default"; | |
| 227 | - $id_param = ""; | |
| 573 | + ?> | |
| 574 | + <tr><td colspan="4"><p><?php esc_html_e( 'There are no websites currently listed for syndication.' ); ?></p></td></tr> | |
| 575 | + <?php | |
| 228 | 576 | endif; |
| 229 | -?> | |
| 230 | -<p>Use the <a href="admin.php?page=<?php print $GLOBALS['fwp_path'] ?>/posts-page.php<?php print $id_param; ?>"><?php _e('Posts'); ?></a> | |
| 231 | -settings page to set up how new posts <?php print $from_this_feed; ?> will be published<?php $by_default; ?>, whether they will accept | |
| 232 | -comments and pings, any custom fields that should be set on each post, etc.</p> | |
| 233 | -<?php | |
| 234 | - fwp_option_box_closer(); | |
| 235 | - } /* FeedWordPressSettingsUI::instead_of_posts_box () */ | |
| 236 | - | |
| 237 | - function instead_of_authors_box ($link_id = null) { | |
| 238 | - if (!is_null($link_id)) : | |
| 239 | - $from_this_feed = 'from this feed'; | |
| 240 | - $by_default = ''; | |
| 241 | - $id_param = "&link_id=".$link_id; | |
| 242 | - else : | |
| 243 | - $from_this_feed = 'from syndicated feeds'; | |
| 244 | - $by_default = " by default"; | |
| 245 | - $id_param = ""; | |
| 577 | + ?> | |
| 578 | + </tbody> | |
| 579 | + </table> <!-- <?php print esc_attr( $table_classes ); ?> --> | |
| 580 | + <?php | |
| 581 | + endif; | |
| 582 | +} /* function fwp_syndication_manage_page_links_table_rows ( ) */ | |
| 583 | + | |
| 584 | +/** | |
| 585 | + * Output HTML message indicating feed errors, if a feed has been returning errors, in Syndicated Sites table. | |
| 586 | + * | |
| 587 | + * @param mixed $the_error If last poll on this feed was successful, this is null. | |
| 588 | + * 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). | |
| 589 | + */ | |
| 590 | +function fwp_links_table_rows_errors_since( $the_error ) { | |
| 591 | + if ( ! is_null( $the_error ) ) : | |
| 592 | + | |
| 593 | + $s_elapsed = fwp_time_elapsed( $the_error['since'] ); | |
| 594 | + $s_recent = fwp_time_elapsed( $the_error['ts'] ); | |
| 595 | + ?> | |
| 596 | + | |
| 597 | +<div class="returning-errors"><p><strong><?php esc_html_e( 'Returning errors' ); ?></strong> <?php esc_html_e( 'since' ); ?> <?php print esc_html( $s_elapsed ); ?></p> | |
| 598 | +<p><?php esc_html_e( 'Most recent' ); ?> (<?php print esc_html( $s_recent ); ?>): | |
| 599 | + <?php | |
| 600 | + foreach ( $the_error['object']->get_error_messages() as $mesg ) : | |
| 601 | + printf( '<br/><code>%s</code>', esc_html( $mesg ) ); | |
| 602 | + endforeach; | |
| 603 | + ?> | |
| 604 | +</p> | |
| 605 | +</div> | |
| 606 | + | |
| 607 | + <?php | |
| 608 | + endif; | |
| 609 | +} | |
| 610 | + | |
| 611 | +/** | |
| 612 | + * Output the "Last checked..." status message in Syndicated Sites table. | |
| 613 | + * | |
| 614 | + * @param SyndicatedLink $o_s_link The SyndicatedLink object representing the feed displayed on this row. | |
| 615 | + */ | |
| 616 | +function fwp_links_table_rows_last_updated( $o_s_link ) { | |
| 617 | + if ( ! is_null( $o_s_link->setting( 'update/last' ) ) ) : | |
| 618 | + print esc_html__( 'Last checked ') . esc_html( fwp_time_elapsed( $o_s_link->setting( 'update/last' ) ) ); | |
| 619 | + else : | |
| 620 | + print esc_html__( 'None yet' ); | |
| 621 | + endif; | |
| 622 | + | |
| 623 | + $ttl = $o_s_link->setting( 'update/ttl' ); | |
| 624 | + if ( is_numeric( $ttl ) ) : | |
| 625 | + $next = $o_s_link->setting( 'update/last' ) + $o_s_link->setting( 'update/fudge' ) + ( (int) $ttl * 60 ); | |
| 626 | + | |
| 627 | + if ( 'automatically' !== $o_s_link->setting( 'update/timed' ) ) : | |
| 628 | + | |
| 629 | + print ' · ' . esc_html__( 'Next') . ' '; | |
| 630 | + print esc_html( fwp_relative_time_string( $next ) ); | |
| 631 | + | |
| 246 | 632 | endif; |
| 633 | + endif; | |
| 247 | 634 | |
| 248 | - fwp_option_box_opener('Syndicated Authors', 'authordiv', 'postbox') | |
| 249 | -?> | |
| 250 | -<p>Use the <a | |
| 251 | -href="admin.php?page=<?php print $GLOBALS['fwp_path'] | |
| 252 | -?>/authors-page.php<?php print $id_param; ?>"><?php _e('Authors'); | |
| 253 | -?></a> settings page to set up how new posts | |
| 254 | -<?php print $from_this_feed; ?> will be assigned to | |
| 255 | -authors.</p> | |
| 256 | -<?php | |
| 257 | - fwp_option_box_closer(); | |
| 258 | - } /* FeedWordPressSettingsUI::instead_of_authors_box () */ | |
| 259 | - | |
| 260 | - function instead_of_categories_box ($link_id = null) { | |
| 261 | - if (!is_null($link_id)) : | |
| 262 | - $from_this_feed = 'from this feed'; | |
| 263 | - $by_default = ''; | |
| 264 | - $id_param = "&link_id=".$link_id; | |
| 635 | +} | |
| 636 | + | |
| 637 | +/** | |
| 638 | + * Return a status message indicating when a feed will next be polled, based on a next-update timestamp. | |
| 639 | + * | |
| 640 | + * @param int $ts Timestamp for next updrate. | |
| 641 | + * @param bool $ago Display "[relative time] ago", or "ASAP", if the timestamp is in the past. | |
| 642 | + */ | |
| 643 | +function fwp_relative_time_string( $ts, $ago = false ) { | |
| 644 | + | |
| 645 | + $dt = ( $ts - time() ); | |
| 646 | + | |
| 647 | + if ( $dt < 0 && ! $ago ) : | |
| 648 | + $ret = __( 'ASAP' ); | |
| 649 | + elseif ( $dt < 60 * 60 ) : | |
| 650 | + $ret = fwp_time_elapsed( $ts ); | |
| 651 | + elseif ( $dt < 60 * 60 * 24 ) : | |
| 652 | + $ret = wp_date( 'g:ia', $ts ); | |
| 653 | + else : | |
| 654 | + $ret = wp_date( 'F j', $ts ); | |
| 655 | + endif; | |
| 656 | + return $ret; | |
| 657 | +} | |
| 658 | + | |
| 659 | +/** | |
| 660 | + * Output the File Size / Format status message in Syndicated Sites table. | |
| 661 | + * | |
| 662 | + * @param SyndicatedLink $o_s_link Object representing the feed displayed on this row. | |
| 663 | + */ | |
| 664 | +function fwp_links_table_rows_file_size( $o_s_link ) { | |
| 665 | + | |
| 666 | + $mesg_file_size_lines = array(); | |
| 667 | + | |
| 668 | + $feed_type = $o_s_link->get_feed_type(); | |
| 669 | + | |
| 670 | + if ( ! is_null( $o_s_link->setting( 'link/item count' ) ) ) : | |
| 671 | + $n = $o_s_link->setting( 'link/item count' ); | |
| 672 | + | |
| 673 | + // translators: %1$d is the item count; %2$s is the plural marker (if any) for item. | |
| 674 | + $mesg_file_size_lines[] = sprintf( __( '%1$d item%2$s' ), $n, _s( $n ) ) . ', ' . $feed_type; | |
| 675 | + | |
| 676 | + endif; | |
| 677 | + | |
| 678 | + if ( is_null( $o_s_link->setting( 'update/error' ) ) ) : | |
| 679 | + | |
| 680 | + if ( ! is_null( $o_s_link->setting( 'link/filesize' ) ) ) : | |
| 681 | + // size_format() _can_ return false, so we check for that first (gwyneth 20230918) | |
| 682 | + $formatted_bytes = size_format( $o_s_link->setting( 'link/filesize' ) ); | |
| 683 | + if ( $formatted_bytes ) : | |
| 684 | + $mesg_file_size_lines[] = $formatted_bytes . ' ' . __( 'total' ); | |
| 685 | + else: | |
| 686 | + $mesg_file_size_lines[] = __( '(invalid number of bytes)' ); | |
| 687 | + endif; | |
| 688 | + FeedWordPress::diagnostic( 'link/filesize', 'File size for this link was reported as being `' . $o_s_link->setting( 'link/filesize' ) . '\'' ); | |
| 265 | 689 | else : |
| 266 | - $from_this_feed = 'from syndicated feeds'; | |
| 267 | - $by_default = " by default"; | |
| 268 | - $id_param = ""; | |
| 690 | + $mesg_file_size_lines[] = __( '(unknown bytes)' ); | |
| 691 | + FeedWordPress::diagnostic( 'link/filesize', 'No error, but link/filesize reported NULL bytes.' ); | |
| 269 | 692 | endif; |
| 270 | - | |
| 271 | - fwp_option_box_opener(__('Categories & Tags'), 'categorydiv', 'postbox'); | |
| 272 | -?> | |
| 273 | -<p>Use the <a href="admin.php?page=<?php print $GLOBALS['fwp_path'] ?>/categories-page.php<?php print $id_param; ?>"><?php _e('Categories & Tags'); ?></a> | |
| 274 | -settings page to set up how new posts <?php print $from_this_feed; ?> are assigned categories or tags<?php print $by_default; ?>.</p> | |
| 275 | -<?php | |
| 276 | - fwp_option_box_closer(); | |
| 277 | - } /* FeedWordPressSettingsUI::instead_of_categories_box () */ | |
| 278 | 693 | |
| 279 | -} /* class FeedWordPressSettingsUI */ | |
| 280 | 694 | |
| 281 | -function fwp_insert_new_user ($newuser_name) { | |
| 282 | - global $wpdb; | |
| 695 | + endif; | |
| 283 | 696 | |
| 284 | - $ret = null; | |
| 285 | - if (strlen($newuser_name) > 0) : | |
| 286 | - $userdata = array(); | |
| 287 | - $userdata['ID'] = NULL; | |
| 288 | - | |
| 289 | - $userdata['user_login'] = sanitize_user($newuser_name); | |
| 290 | - $userdata['user_login'] = apply_filters('pre_user_login', $userdata['user_login']); | |
| 291 | - | |
| 292 | - $userdata['user_nicename'] = sanitize_title($newuser_name); | |
| 293 | - $userdata['user_nicename'] = apply_filters('pre_user_nicename', $userdata['user_nicename']); | |
| 294 | - | |
| 295 | - $userdata['display_name'] = $wpdb->escape($newuser_name); | |
| 697 | + if ( count( $mesg_file_size_lines ) > 0 ) : | |
| 296 | 698 | |
| 297 | - $newuser_id = wp_insert_user($userdata); | |
| 298 | - if (is_numeric($newuser_id)) : | |
| 299 | - $ret = $newuser_id; | |
| 699 | + print '<div>'; | |
| 700 | + $sep = ''; | |
| 701 | + foreach ( $mesg_file_size_lines as $line ) : | |
| 702 | + print esc_html( $sep ); | |
| 703 | + print esc_html( $line ); | |
| 704 | + $sep = ' / '; | |
| 705 | + endforeach; | |
| 706 | + print '</div>'; | |
| 707 | + | |
| 708 | + endif; | |
| 709 | + | |
| 710 | +} | |
| 711 | + | |
| 712 | +/** | |
| 713 | + * Output the Scheduled For Next Update status message in Syndicated Sites table. | |
| 714 | + * | |
| 715 | + * @param SyndicatedLink $o_s_link Object representing the feed displayed on this row. | |
| 716 | + */ | |
| 717 | +function fwp_links_table_rows_next_update( $o_s_link ) { | |
| 718 | + $ttl = $o_s_link->setting( 'update/ttl' ); | |
| 719 | + ?> | |
| 720 | + <div style="max-width: 30.0em; font-size: 0.9em;"><div style="font-style:italic;"> | |
| 721 | + <?php | |
| 722 | + if ( is_numeric( $ttl ) ) : | |
| 723 | + $next = $o_s_link->setting( 'update/last' ) + $o_s_link->setting( 'update/fudge' ) + ( (int) $ttl * 60 ); | |
| 724 | + if ( 'automatically' === $o_s_link->setting( 'update/timed' ) ) : | |
| 725 | + if ( $next < time() ) : | |
| 726 | + esc_html_e( 'Ready and waiting to be updated since ' ); | |
| 727 | + else : | |
| 728 | + esc_html_e( 'Scheduled for next update ' ); | |
| 729 | + endif; | |
| 730 | + | |
| 731 | + print esc_html( fwp_time_elapsed( $next ) ); | |
| 732 | + if ( FEEDWORDPRESS_DEBUG ) : | |
| 733 | + $interval = ( ( $next - time() ) / 60 ); | |
| 734 | + printf( ' [%d %s%s]', intval( $interval ), esc_html__( 'minute' ), esc_html( _s( $interval ) ) ); | |
| 735 | + endif; | |
| 300 | 736 | else : |
| 301 | - // TODO: Add some error detection and reporting | |
| 737 | + printf( esc_html__( 'Scheduled to be checked for updates every ' ) . '%d %s%s.', | |
| 738 | + intval( $ttl ), | |
| 739 | + esc_html__( 'minute' ), | |
| 740 | + esc_html( _s( $ttl ) ) ); | |
| 741 | + ?> | |
| 742 | + </div> | |
| 743 | + | |
| 744 | + <div style="size:0.9em; margin-top: 0.5em"><?php esc_html_e( 'This update schedule was requested by the feed provider' ); ?> | |
| 745 | + <?php | |
| 746 | + if ( $o_s_link->setting( 'update/xml' ) ) : | |
| 747 | + ?> | |
| 748 | + <?php esc_html_e( 'using a standard' ); ?> <code style="font-size: inherit; padding: 0; background: transparent"><<?php print esc_html( $o_s_link->setting( 'update/xml' ) ); ?>></code> <?php esc_html_e( 'element' ); // Note: the tricky php tags placed here try to avoid a space before the period. (gwyneth 20230918) | |
| 749 | + endif; | |
| 302 | 750 | endif; |
| 303 | 751 | else : |
| 304 | - // TODO: Add some error reporting | |
| 752 | + esc_html_e( 'Scheduled for update as soon as possible' ); | |
| 305 | 753 | endif; |
| 306 | - return $ret; | |
| 307 | -} /* fwp_insert_new_user () */ | |
| 308 | - | |
| 754 | + print '.'; | |
| 755 | + ?> | |
| 756 | + </div></div> | |
| 757 | + <?php | |
| 758 | +} | |
