← All changes | feedwordpress.php +2136 -1063 2010.0127 → 2024.0511 View file →

		@@ -2,550 +2,266 @@
2	2	/*
3	3	Plugin Name: FeedWordPress
4	4	Plugin URI: http://feedwordpress.radgeek.com/
5	5	Description: simple and flexible Atom/RSS syndication for WordPress
6		-Version: 2010.0127
7		-Author: Charles Johnson
8		-Author URI: http://radgeek.com/
	6	+Version: 2024.0511
	7	+Author: C. Johnson
	8	+Author URI: https://feedwordpress.radgeek.com/contact/
9	9	License: GPL
10	10	*/
11	11
12		-# This uses code derived from:
	12	+/**
	13	+ * @package FeedWordPress
	14	+ * @version 2024.0511
	15	+ */
	16	+
	17	+# This plugin uses code derived from:
13	18	# - wp-rss-aggregate.php by Kellan Elliot-McCrea <kellan@protest.net>
14		-# - HTTP Navigator 2 by Keyvan Minoukadeh <keyvan@k1m.com>
	19	+# - SimplePie feed parser by Ryan Parman, Geoffrey Sneddon, Ryan McCue, et al.
	20	+# - MagpieRSS feed parser by Kellan Elliot-McCrea <kellan@protest.net>
15	21	# - Ultra-Liberal Feed Finder by Mark Pilgrim <mark@diveintomark.org>
	22	+# - WordPress Blog Tool and Publishing Platform <http://wordpress.org/>
	23	+# - Github contributors @Flynsarmy, @BandonRandon, @david-robinson-practiceweb,
	24	+# @daidais, @thegreatmichael, @stedaniels, @alexiskulash, @quassy, @zoul0813,
	25	+# @timmmmyboy, @vobornik, @inanimatt, @tristanleboss, @martinburchell,
	26	+# @bigalownz, @oppiansteve, and @GwynethLlewelyn
16	27	# according to the terms of the GNU General Public License.
17		-#
18		-# INSTALLATION: see readme.txt or <http://projects.radgeek.com/install>
19		-#
20		-# USAGE: once FeedWordPress is installed, you manage just about everything from
21		-# the WordPress Dashboard, under the Syndication menu. To ensure that fresh
22		-# content is added as it becomes available, you can convince your contributors
23		-# to put your XML-RPC URI (if WordPress is installed at
24		-# <http://www.zyx.com/blog>, XML-RPC requests should be sent to
25		-# <http://www.zyx.com/blog/xmlrpc.php>), or update manually under the
26		-# Syndication menu, or set up automatic updates under Syndication --> Settings,
27		-# or use a cron job.
28	28
29		-# -- Don't change these unless you know what you're doing...
	29	+####################################################################################
	30	+## CONSTANTS & DEFAULTS ############################################################
	31	+####################################################################################
30	32
31		-define ('FEEDWORDPRESS_VERSION', '2010.0127');
32		-define ('FEEDWORDPRESS_AUTHOR_CONTACT', 'http://radgeek.com/contact');
	33	+define ('FEEDWORDPRESS_VERSION', '2024.0511');
	34	+define ('FEEDWORDPRESS_AUTHOR_CONTACT', 'https://feedwordpress.radgeek.com/contact' );
33	35
	36	+if ( ! defined( 'FEEDWORDPRESS_BLEG' ) ) :
	37	+ define ( 'FEEDWORDPRESS_BLEG', true );
	38	+endif;
	39	+
	40	+define( 'FEEDWORDPRESS_BLEG_BTC_pre_2020', '15EsQ9QMZtLytsaVYZUaUCmrkSMaxZBTso' );
	41	+define( 'FEEDWORDPRESS_BLEG_BTC_2020', '1NB1ebYVb68Har4WijmE8gKnZ47NptCqtB' ); // 2020.0201
	42	+define( 'FEEDWORDPRESS_BLEG_BTC', '1HCDdeGcR66EPxkPT2rbdTd1ezh27pmjPR' ); // 2021.0713
	43	+
	44	+define( 'FEEDWORDPRESS_BLEG_PAYPAL', '22PAJZZCK5Z3W' );
	45	+
34	46	// Defaults
35		-define ('DEFAULT_SYNDICATION_CATEGORY', 'Contributors');
36		-define ('DEFAULT_UPDATE_PERIOD', 60); // value in minutes
	47	+define( 'DEFAULT_SYNDICATION_CATEGORY', 'Contributors' );
	48	+define( 'DEFAULT_UPDATE_PERIOD', 60 ); // value in minutes
	49	+define( 'FEEDWORDPRESS_DEFAULT_CHECKIN_INTERVAL', DEFAULT_UPDATE_PERIOD / 10 );
37	50
38		-if (isset($_REQUEST['feedwordpress_debug'])) :
39		- $feedwordpress_debug = $_REQUEST['feedwordpress_debug'];
40		-else :
41		- $feedwordpress_debug = get_option('feedwordpress_debug');
42		- if (is_string($feedwordpress_debug)) :
43		- $feedwordpress_debug = ($feedwordpress_debug == 'yes');
44		- endif;
	51	+// Dependencies: modules packaged with FeedWordPress plugin.
	52	+/** @var string Path to parent directory */
	53	+$dir = dirname( __FILE__ );
	54	+require_once "{$dir}/externals/myphp/myphp.class.php";
	55	+
	56	+/** @var bool|string Set to either true or 'yes' if debugging is set. */
	57	+$feedwordpress_debug = FeedWordPress::param( 'feedwordpress_debug', get_option( 'feedwordpress_debug' ) );
	58	+
	59	+if ( is_string( $feedwordpress_debug ) ) :
	60	+ $feedwordpress_debug = ( $feedwordpress_debug == 'yes' );
45	61	endif;
46		-define ('FEEDWORDPRESS_DEBUG', $feedwordpress_debug);
47	62
48		-define ('FEEDWORDPRESS_CAT_SEPARATOR_PATTERN', '/[:\n]/');
49		-define ('FEEDWORDPRESS_CAT_SEPARATOR', "\n");
	63	+define ( 'FEEDWORDPRESS_DEBUG', $feedwordpress_debug );
	64	+$feedwordpress_compatibility = true;
	65	+define ( 'FEEDWORDPRESS_COMPATIBILITY', $feedwordpress_compatibility );
50	66
51		-define ('FEEDVALIDATOR_URI', 'http://feedvalidator.org/check.cgi');
	67	+define ( 'FEEDWORDPRESS_CAT_SEPARATOR_PATTERN', '/[:\n]/' );
	68	+define ( 'FEEDWORDPRESS_CAT_SEPARATOR', "\n" );
52	69
53		-define ('FEEDWORDPRESS_FRESHNESS_INTERVAL', 10*60); // Every ten minutes
	70	+// define ('FEEDVALIDATOR_URI', 'http://feedvalidator.org/check.cgi'); // Link dead (gwyneth 20210617)
	71	+define ( 'FEEDVALIDATOR_URI', 'https://validator.w3.org/feed/check.cgi' ); // Falling back to the W3C validator link
54	72
55		-define ('FWP_SCHEMA_HAS_USERMETA', 2966);
56		-define ('FWP_SCHEMA_20', 3308); // Database schema # for WP 2.0
57		-define ('FWP_SCHEMA_21', 4772); // Database schema # for WP 2.1
58		-define ('FWP_SCHEMA_23', 5495); // Database schema # for WP 2.3
59		-define ('FWP_SCHEMA_25', 7558); // Database schema # for WP 2.5
60		-define ('FWP_SCHEMA_26', 8201); // Database schema # for WP 2.6
61		-define ('FWP_SCHEMA_27', 9872); // Database schema # for WP 2.7
62		-define ('FWP_SCHEMA_28', 11548); // Database schema # for WP 2.8
63		-define ('FWP_SCHEMA_29', 12329); // Database schema # for WP 2.9
	73	+define ( 'FEEDWORDPRESS_FRESHNESS_INTERVAL', 10 * 60 ); // Every ten minutes
64	74
65		-if (FEEDWORDPRESS_DEBUG) :
	75	+define( 'FEEDWORDPRESS_BOILERPLATE_DEFAULT_HOOK_ORDER', 11000 ); // at the tail end of the filtering process
	76	+
	77	+if ( FEEDWORDPRESS_DEBUG ) :
66	78	// Help us to pick out errors, if any.
67		- ini_set('error_reporting', E_ALL & ~E_NOTICE);
68		- ini_set('display_errors', true);
69		- define('MAGPIE_DEBUG', true);
70		-
	79	+ ini_set( 'error_reporting', E_ALL & ~E_NOTICE );
	80	+ ini_set( 'display_errors', true );
	81	+
71	82	// When testing we don't want cache issues to interfere. But this is
72		- // a VERY BAD SETTING for a production server. Webmasters will eat your
	83	+ // a VERY BAD SETTING for a production server. Webmasters will eat your
73	84	// face for breakfast if you use it, and the baby Jesus will cry. So
74	85	// make sure FEEDWORDPRESS_DEBUG is FALSE for any site that will be
75	86	// used for more than testing purposes!
76		- define('MAGPIE_CACHE_AGE', 1);
	87	+ define( 'FEEDWORDPRESS_CACHE_AGE', 1 );
	88	+ define( 'FEEDWORDPRESS_CACHE_LIFETIME', 1 );
	89	+ define( 'FEEDWORDPRESS_FETCH_TIMEOUT_DEFAULT', 60 );
77	90	else :
78		- define('MAGPIE_DEBUG', false);
79		-
80		- define('MAGPIE_CACHE_AGE', 1*60);
	91	+ // Hold onto data all day for conditional GET purposes,
	92	+ // but consider it stale after 1 min (requiring a conditional GET)
	93	+ define( 'FEEDWORDPRESS_CACHE_LIFETIME', 24 * 60 * 60 ); // aka one day.
	94	+ define( 'FEEDWORDPRESS_CACHE_AGE', 1 * 60 );
	95	+ define( 'FEEDWORDPRESS_FETCH_TIMEOUT_DEFAULT', 20 );
81	96	endif;
82	97
83		-// Note that the rss-functions.php that comes prepackaged with WordPress is
84		-// old & busted. For the new hotness, drop a copy of rss.php from
85		-// this archive into wp-includes/rss.php
	98	+####################################################################################
	99	+## CORE DEPENDENCIES & PLUGIN MODULES ##############################################
	100	+####################################################################################
86	101
87		-if (is_readable(ABSPATH . WPINC . '/rss.php')) :
88		- require_once (ABSPATH . WPINC . '/rss.php');
89		-else :
90		- require_once (ABSPATH . WPINC . '/rss-functions.php');
91		-endif;
	102	+/** @var array<string> Dependencies: modules packaged with WordPress core */
	103	+$wpCoreDependencies = array(
	104	+ "class:SimplePie" => "class-simplepie",
	105	+ "class:WP_SimplePie_File" => "class-wp-simplepie-file",
	106	+ "class:WP_SimplePie_Sanitize_KSES" => "class-wp-simplepie-sanitize-kses",
	107	+ "function:wp_insert_user" => "registration",
	108	+);
92	109
93		-if (isset($wp_db_version)) :
94		- if ($wp_db_version >= FWP_SCHEMA_23) :
95		- require_once (ABSPATH . WPINC . '/registration.php'); // for wp_insert_user
96		- elseif ($wp_db_version >= FWP_SCHEMA_21) : // WordPress 2.1 and 2.2, but not 2.3
97		- require_once (ABSPATH . WPINC . '/registration.php'); // for wp_insert_user
98		- require_once (ABSPATH . 'wp-admin/admin-db.php'); // for wp_insert_category
99		- elseif ($wp_db_version >= FWP_SCHEMA_20) : // WordPress 2.0
100		- require_once (ABSPATH . WPINC . '/registration-functions.php'); // for wp_insert_user
101		- require_once (ABSPATH . 'wp-admin/admin-db.php'); // for wp_insert_category
	110	+// Ensure that we have SimplePie loaded up and ready to go
	111	+// along with the WordPress auxiliary classes.
	112	+$unmetCoreDependencies = array();
	113	+foreach ( $wpCoreDependencies as $unit => $fileSlug ) :
	114	+ list( $unitType, $unitName ) = explode( ":", $unit, 2 );
	115	+
	116	+ $dependencyMet = ( ('class' == $unitType ) ? class_exists( $unitName ) : function_exists( $unitName ) );
	117	+ if ( ! $dependencyMet ) :
	118	+ $phpFileName = ABSPATH . WPINC . "/{$fileSlug}.php";
	119	+ if ( file_exists( $phpFileName ) ) :
	120	+ require_once $phpFileName;
	121	+ else :
	122	+ $unmetCoreDependencies[] = $unitName;
	123	+ endif;
102	124	endif;
	125	+endforeach;
	126	+
	127	+// Fallback garbage-pail module used in WP < 4.7 which may meet our dependencies
	128	+if ( count( $unmetCoreDependencies ) > 0 ) :
	129	+ require_once ABSPATH . WPINC . "/class-feed.php";
103	130	endif;
104	131
105		-require_once(dirname(__FILE__) . '/compatability.php'); // LEGACY API: Replicate or mock up functions for legacy support purposes
106		-require_once(dirname(__FILE__) . '/feedwordpresshtml.class.php');
	132	+// Dependencies: modules packaged with FeedWordPress plugin
	133	+$dir = dirname( __FILE__ );
	134	+require_once "{$dir}/feedwordpressadminpage.class.php";
	135	+require_once "{$dir}/feedwordpresssettingsui.class.php";
	136	+require_once "{$dir}/feedwordpressdiagnostic.class.php";
	137	+require_once "{$dir}/admin-ui.php";
	138	+require_once "{$dir}/template-functions.php";
	139	+require_once "{$dir}/feedwordpresssyndicationpage.class.php";
	140	+require_once "{$dir}/compatability.php"; // Legacy API
	141	+require_once "{$dir}/syndicatedpost.class.php";
	142	+require_once "{$dir}/syndicatedlink.class.php";
	143	+require_once "{$dir}/feedwordpresshtml.class.php";
	144	+require_once "{$dir}/inspectpostmeta.class.php";
	145	+require_once "{$dir}/syndicationdataqueries.class.php";
	146	+require_once "{$dir}/extend/SimplePie/feedwordpie.class.php";
	147	+require_once "{$dir}/extend/SimplePie/feedwordpie_cache.class.php";
	148	+require_once "{$dir}/extend/SimplePie/feedwordpie_item.class.php";
	149	+require_once "{$dir}/extend/SimplePie/feedwordpie_file.class.php";
	150	+require_once "{$dir}/extend/SimplePie/feedwordpie_parser.class.php";
	151	+require_once "{$dir}/extend/SimplePie/feedwordpie_content_type_sniffer.class.php";
	152	+require_once "{$dir}/feedwordpressrpc.class.php";
	153	+require_once "{$dir}/feedwordpresshttpauthenticator.class.php";
	154	+require_once "{$dir}/feedwordpresslocalpost.class.php";
107	155
108		-// Magic quotes are just about the stupidest thing ever.
109		-if (is_array($_POST)) :
110		- $fwp_post = stripslashes_deep($_POST);
111		-endif;
	156	+####################################################################################
	157	+## GLOBAL PARAMETERS ###############################################################
	158	+####################################################################################
112	159
113	160	// Get the path relative to the plugins directory in which FWP is stored
114	161	preg_match (
115		- '|/wp-content/plugins/(.+)$|',
116		- dirname(__FILE__),
	162	+ '|'.preg_quote( WP_PLUGIN_DIR ) . '/(.+)$|',
	163	+ dirname( __FILE__ ),
117	164	$ref
118	165	);
119	166
120		-if (isset($ref[1])) :
	167	+if ( isset( $ref[1] ) ) :
121	168	$fwp_path = $ref[1];
122	169	else : // Something went wrong. Let's just guess.
123	170	$fwp_path = 'feedwordpress';
124	171	endif;
125	172
126		-function feedwordpress_admin_scripts () {
127		- wp_enqueue_script('post'); // for magic tag and category boxes
128		- wp_enqueue_script('admin-forms'); // for checkbox selection
129		-}
	173	+####################################################################################
	174	+## FEEDWORDPRESS: INITIALIZE OBJECT AND FILTERS ####################################
	175	+####################################################################################
130	176
131		-// If this is a FeedWordPress admin page, queue up scripts for AJAX functions that FWP uses
132		-// If it is a display page or a non-FeedWordPress admin page, don't.
133		-if (is_admin() and isset($_REQUEST['page']) and preg_match("|^{$fwp_path}/|", $_REQUEST['page'])) :
134		- if (function_exists('wp_enqueue_script')) :
135		- if (FeedWordPressCompatibility::test_version(FWP_SCHEMA_29)) :
136		- add_action('admin_print_scripts', 'feedwordpress_admin_scripts');
137		- elseif (FeedWordPressCompatibility::test_version(FWP_SCHEMA_25)) :
138		- wp_enqueue_script('post'); // for magic tag and category boxes
139		- wp_enqueue_script('thickbox'); // for fold-up boxes
140		- wp_enqueue_script('admin-forms'); // for checkbox selection
141		- else :
142		- wp_enqueue_script( 'ajaxcat' ); // Provides the handy-dandy new category text box
143		- endif;
144		- endif;
145		- if (function_exists('wp_enqueue_style')) :
146		- if (fwp_test_wp_version(FWP_SCHEMA_25)) :
147		- wp_enqueue_style('dashboard');
148		- endif;
149		- endif;
150		- if (function_exists('wp_admin_css')) :
151		- if (fwp_test_wp_version(FWP_SCHEMA_25)) :
152		- wp_admin_css('css/dashboard');
153		- endif;
154		- endif;
155		-endif;
	177	+$feedwordpress = new FeedWordPress;
	178	+if ( ! $feedwordpress->needs_upgrade() ) : // only work if the conditions are safe!
	179	+ $feedwordpress->add_filters();
156	180
157		-if (!FeedWordPress::needs_upgrade()) : // only work if the conditions are safe!
	181	+ # Inbound XML-RPC update methods
	182	+ $feedwordpressRPC = new FeedWordPressRPC;
158	183
159		- # Syndicated items are generally received in output-ready (X)HTML and
160		- # should not be folded, crumpled, mutilated, or spindled by WordPress
161		- # formatting filters. But we don't want to interfere with filters for
162		- # any locally-authored posts, either.
163		- #
164		- # What WordPress should really have is a way for upstream filters to
165		- # stop downstream filters from running at all. Since it doesn't, and
166		- # since a downstream filter can't access the original copy of the text
167		- # that is being filtered, what we will do here is (1) save a copy of the
168		- # original text upstream, before any other filters run, and then (2)
169		- # retrieve that copy downstream, after all the other filters run, *if*
170		- # this is a syndicated post
171		-
172		- add_filter('the_content', 'feedwordpress_preserve_syndicated_content', -10000);
173		- add_filter('the_content', 'feedwordpress_restore_syndicated_content', 10000);
174		-
175		- add_action('atom_entry', 'feedwordpress_item_feed_data');
176		-
177		- # Filter in original permalinks if the user wants that
178		- add_filter('post_link', 'syndication_permalink', 1);
179		-
180		- # WTF? By default, wp_insert_link runs incoming link_url and link_rss
181		- # URIs through default filters that include `wp_kses()`. But `wp_kses()`
182		- # just happens to escape any occurrence of & to &amp; -- which just
183		- # happens to fuck up any URI with a & to separate GET parameters.
184		- remove_filter('pre_link_rss', 'wp_filter_kses');
185		- remove_filter('pre_link_url', 'wp_filter_kses');
186		-
187		- # Admin menu
188		- add_action('admin_menu', 'fwp_add_pages');
189		- add_action('admin_notices', 'fwp_check_debug');
190		- add_action('admin_notices', 'fwp_check_magpie');
191		- add_action('init', 'feedwordpress_check_for_magpie_fix');
192		-
193		- add_action('admin_menu', 'feedwordpress_add_post_edit_controls');
194		- add_action('save_post', 'feedwordpress_save_post_edit_controls');
195		-
196		- # Inbound XML-RPC update methods
197		- add_filter('xmlrpc_methods', 'feedwordpress_xmlrpc_hook');
198		-
199	184	# Outbound XML-RPC ping reform
200		- remove_action('publish_post', 'generic_ping'); // WP 1.5.x
201		- remove_action('do_pings', 'do_all_pings', 10, 1); // WP 2.1, 2.2
202		- remove_action('publish_post', '_publish_post_hook', 5, 1); // WP 2.3
	185	+ remove_action( 'publish_post', 'generic_ping' ); // WP 1.5.x
	186	+ remove_action( 'do_pings', 'do_all_pings', 10, 1 ); // WP 2.1, 2.2
	187	+ remove_action( 'publish_post', '_publish_post_hook', 5, 1 ); // WP 2.3
203	188
204		- add_action('publish_post', 'fwp_publish_post_hook', 5, 1);
205		- add_action('do_pings', 'fwp_do_pings', 10, 1);
206		- add_action('feedwordpress_update', 'fwp_hold_pings');
207		- add_action('feedwordpress_update_complete', 'fwp_release_pings');
	189	+ add_action( 'publish_post', 'fwp_publish_post_hook', 5, 1 );
	190	+ add_action( 'do_pings', 'fwp_do_pings', 10, 1 );
	191	+ add_action( 'feedwordpress_update', 'fwp_hold_pings' );
	192	+ add_action( 'feedwordpress_update_complete', 'fwp_release_pings' );
208	193
209		- # Hook in logging functions only if the logging option is ON
210		- $update_logging = get_option('feedwordpress_update_logging');
211		- if ($update_logging == 'yes') :
212		- add_action('post_syndicated_item', 'log_feedwordpress_post', 100);
213		- add_action('update_syndicated_item', 'log_feedwordpress_update_post', 100);
214		- add_action('feedwordpress_update', 'log_feedwordpress_update_feeds', 100);
215		- add_action('feedwordpress_check_feed', 'log_feedwordpress_check_feed', 100);
216		- add_action('feedwordpress_update_complete', 'log_feedwordpress_update_complete', 100);
217		- endif;
218		-
219		- if (FeedWordPress::update_requested() and FEEDWORDPRESS_DEBUG) :
220		- add_action('post_syndicated_item', 'debug_out_feedwordpress_post', 100);
221		- add_action('update_syndicated_item', 'debug_out_feedwordpress_update_post', 100);
222		- add_action('feedwordpress_update', 'debug_out_feedwordpress_update_feeds', 100);
223		- add_action('feedwordpress_check_feed', 'debug_out_feedwordpress_check_feed', 100);
224		- add_action('feedwordpress_update_complete', 'debug_out_feedwordpress_update_complete', 100);
225		- endif;
226		-
227		- # Cron-less auto-update. Hooray!
228		- $autoUpdateHook = get_option('feedwordpress_automatic_updates');
229		- if ($autoUpdateHook != 'init') :
230		- $autoUpdateHook = 'shutdown';
231		- endif;
232		- add_action($autoUpdateHook, 'feedwordpress_auto_update');
233		-
234		- add_action('init', 'feedwordpress_update_magic_url');
235		-
236		- # Default sanitizers
237		- add_filter('syndicated_item_content', array('SyndicatedPost', 'resolve_relative_uris'), 0, 2);
238		- add_filter('syndicated_item_content', array('SyndicatedPost', 'sanitize_content'), 0, 2);
239		-
240	194	else :
241	195	# Hook in the menus, which will just point to the upgrade interface
242		- add_action('admin_menu', 'fwp_add_pages');
243		-endif; // if (!FeedWordPress::needs_upgrade())
	196	+ add_action( 'admin_menu', array( $feedwordpress, 'add_pages' ) );
	197	+endif; // if ( !FeedWordPress::needs_upgrade())
244	198
245		-function feedwordpress_check_for_magpie_fix () {
246		- if (isset($_POST['action']) and $_POST['action']=='fix_magpie_version') :
247		- FeedWordPressCompatibility::validate_http_request(/*action=*/ 'feedwordpress_fix_magpie', /*capability=*/ 'edit_files');
	199	+register_deactivation_hook( __FILE__, 'feedwordpress_deactivate' );
248	200
249		- $back_to = $_SERVER['REQUEST_URI'];
250		- if (isset($_POST['ignore'])) :
251		- // kill error message by telling it we ignored the upgrade request for this version
252		- update_option('feedwordpress_magpie_ignored_upgrade_to', EXPECTED_MAGPIE_VERSION);
253		- $ret = 'ignored';
254		- elseif (isset($_POST['upgrade'])) :
255		- $source = dirname(__FILE__)."/MagpieRSS-upgrade/rss.php";
256		- $destination = ABSPATH . WPINC . '/rss.php';
257		- $success = @copy($source, $destination);
	201	+/**
	202	+ * Hook to deactivate FeedWordPress.
	203	+ *
	204	+ * @return int|false @see wp_clear_scheduled_hook()
	205	+ */
	206	+function feedwordpress_deactivate() {
	207	+ wp_clear_scheduled_hook( 'fwp_scheduled_update_checkin' );
	208	+} /* feedwordpress_deactivate () */
258	209
259		- // Copy over rss-functions.php, too, to avoid collisions
260		- // on pre-lapsarian versions of WordPress.
261		- if ($success) :
262		- $source = dirname(__FILE__)."/MagpieRSS-upgrade/rss-functions.php";
263		- $destination = ABSPATH . WPINC . '/rss-functions.php';
264		- $success = @copy($source, $destination);
265		- endif;
266		- $ret = (int) $success;
267		- endif;
268		-
269		- if (strpos($back_to, '?')===false) : $sep = '?';
270		- else : $sep = '&';
271		- endif;
272		-
273		- header("Location: {$back_to}{$sep}feedwordpress_magpie_fix=".$ret);
274		- exit;
275		- endif;
276		-} /* feedwordpress_check_for_magpie_fix() */
277		-
278		-function feedwordpress_auto_update () {
279		- if (FeedWordPress::stale()) :
280		- $feedwordpress =& new FeedWordPress;
281		- $feedwordpress->update();
282		- endif;
283		-} /* feedwordpress_auto_update () */
284		-
285		-function feedwordpress_update_magic_url () {
286		- global $wpdb;
287		-
288		- // Explicit update request in the HTTP request (e.g. from a cron job)
289		- if (FeedWordPress::update_requested()) :
290		- $feedwordpress =& new FeedWordPress;
291		- $feedwordpress->update(FeedWordPress::update_requested_url());
292		-
293		- if (FEEDWORDPRESS_DEBUG and count($wpdb->queries) > 0) :
294		- $mysqlTime = 0.0;
295		- $byTime = array();
296		- foreach ($wpdb->queries as $query) :
297		- $time = $query[1] * 1000000.0;
298		- $mysqlTime += $query[1];
299		- if (!isset($byTime[$time])) : $byTime[$time] = array(); endif;
300		- $byTime[$time][] = $query[0]. ' // STACK: ' . $query[2];
301		- endforeach;
302		- krsort($byTime);
303		-
304		- foreach ($byTime as $time => $querySet) :
305		- foreach ($querySet as $query) :
306		- print "[".(sprintf('%4.4f', $time/1000.0)) . "ms] $query\n";
307		- endforeach;
308		- endforeach;
309		- echo "[feedwordpress] $wpdb->num_queries queries. $mysqlTime seconds in MySQL. Total of "; timer_stop(1); print " seconds.";
310		- endif;
311		-
312		-
313		- // Magic URL should return nothing but a 200 OK header packet
314		- // when successful.
315		- exit;
316		- endif;
317		-} /* feedwordpress_magic_update_url () */
318		-
319	210	################################################################################
320	211	## LOGGING FUNCTIONS: log status updates to error_log if you want it ###########
321	212	################################################################################
322	213
323		-function log_feedwordpress_post ($id) {
324		- $post = wp_get_single_post($id);
325		- error_log("[".date('Y-m-d H:i:s')."][feedwordpress] posted "
326		- ."'{$post->post_title}' ({$post->post_date})");
327		-}
328		-
329		-function log_feedwordpress_update_post ($id) {
330		- $post = wp_get_single_post($id);
331		- error_log("[".date('Y-m-d H:i:s')."][feedwordpress] updated "
332		- ."'{$post->post_title}' ({$post->post_date})"
333		- ." (as of {$post->post_modified})");
334		-}
335		-
336		-function log_feedwordpress_update_feeds ($uri) {
337		- error_log("[".date('Y-m-d H:i:s')."][feedwordpress] update('$uri')");
338		-}
339		-
340		-function log_feedwordpress_check_feed ($feed) {
341		- $uri = $feed['link/uri']; $name = $feed['link/name'];
342		- error_log("[".date('Y-m-d H:i:s')."][feedwordpress] Examining $name <$uri>");
343		-}
344		-
345		-function log_feedwordpress_update_complete ($delta) {
346		- $mesg = array();
347		- if (isset($delta['new'])) $mesg[] = 'added '.$delta['new'].' new posts';
348		- if (isset($delta['updated'])) $mesg[] = 'updated '.$delta['updated'].' existing posts';
349		- if (empty($mesg)) $mesg[] = 'nothing changed';
350		-
351		- error_log("[".date('Y-m-d H:i:s')."][feedwordpress] "
352		- .(is_null($delta) ? "Error: I don't syndicate that URI"
353		- : implode(' and ', $mesg)));
354		-}
355		-
356		-function debug_out_feedwordpress_post ($id) {
357		- $post = wp_get_single_post($id);
358		- print ("[".date('Y-m-d H:i:s')."][feedwordpress] posted "
359		- ."'{$post->post_title}' ({$post->post_date})\n");
360		-}
361		-
362		-function debug_out_feedwordpress_update_post ($id) {
363		- $post = wp_get_single_post($id);
364		- print ("[".date('Y-m-d H:i:s')."][feedwordpress] updated "
365		- ."'{$post->post_title}' ({$post->post_date})"
366		- ." (as of {$post->post_modified})\n");
367		-}
368		-
369		-function debug_out_feedwordpress_update_feeds ($uri) {
370		- print ("[".date('Y-m-d H:i:s')."][feedwordpress] update('$uri')\n");
371		-}
372		-
373		-function debug_out_feedwordpress_check_feed ($feed) {
374		- $uri = $feed['link/uri']; $name = $feed['link/name'];
375		- print ("[".date('Y-m-d H:i:s')."][feedwordpress] Examining $name <$uri>\n");
376		-}
377		-
378		-function debug_out_feedwordpress_update_complete ($delta) {
379		- $mesg = array();
380		- if (isset($delta['new'])) $mesg[] = 'added '.$delta['new'].' new posts';
381		- if (isset($delta['updated'])) $mesg[] = 'updated '.$delta['updated'].' existing posts';
382		- if (empty($mesg)) $mesg[] = 'nothing changed';
383		-
384		- print ("[".date('Y-m-d H:i:s')."][feedwordpress] "
385		- .(is_null($delta) ? "Error: I don't syndicate that URI"
386		- : implode(' and ', $mesg))."\n");
387		-}
388		-
389		-################################################################################
390		-## TEMPLATE API: functions to make your templates syndication-aware ############
391		-################################################################################
392		-
393		-function is_syndicated ($id = NULL) { return (strlen(get_syndication_feed_id($id)) > 0); }
394		-
395		-function get_syndication_source_link ($original = NULL, $id = NULL) {
396		- if (is_null($original)) : $original = FeedWordPress::use_aggregator_source_data();
	214	+/**
	215	+ * Divides bytes into units of higher magnitude (e.g KB, MB, etc).
	216	+ *
	217	+ * @param int|string $quantity Quantity in bytes to be displayed. Can be a string that only includes numeric digits.
	218	+ *
	219	+ * @return string Formatted string with quantity and unit.
	220	+ *
	221	+ * @deprecated use the WordPress built-in `size_format()` function instead! (gwyneth 20230918)
	222	+ */
	223	+function debug_out_human_readable_bytes( $quantity ) {
	224	+ if ( ! is_numeric( $quantity ) ) :
	225	+ return __( "(wrong quantity)" );
397	226	endif;
398		-
399		- if ($original) : $vals = get_post_custom_values('syndication_source_uri_original', $id);
400		- else : $vals = array();
401		- endif;
402		-
403		- if (count($vals) == 0) : $vals = get_post_custom_values('syndication_source_uri', $id);
404		- endif;
405		-
406		- if (count($vals) > 0) : $ret = $vals[0]; else : $ret = NULL; endif;
407		-
408		- return $ret;
409		-} /* function get_syndication_source_link() */
410		-
411		-function the_syndication_source_link ($original = NULL, $id = NULL) {
412		- echo get_syndication_source_link($original, $id);
	227	+ $quantity = intval( $quantity );
	228	+ $magnitude = 'B';
	229	+ /** @var array Two-letter abbreviations of the units in increasing magnitude. */
	230	+ $orders = array( 'KB', 'MB', 'GB', 'TB' );
	231	+ while ( ( $quantity > ( 1024 * 100 ) ) and ( count( $orders ) > 0 ) ) :
	232	+ $quantity = floor( $quantity / 1024 );
	233	+ $magnitude = array_shift( $orders );
	234	+ endwhile;
	235	+ return "{$quantity} {$magnitude}";
413	236	}
414	237
415		-function feedwordpress_display_url ($url, $before = 60, $after = 0) {
416		- $bits = parse_url($url);
417		-
418		- // Strip out crufty subdomains
419		- $bits['host'] = preg_replace('/^www[0-9]*\./i', '', $bits['host']);
420		-
421		- // Reassemble bit-by-bit with minimum of crufty elements
422		- $url = (isset($bits['user'])?$bits['user'].'@':'')
423		- .(isset($bits['host'])?$bits['host']:'')
424		- .(isset($bits['path'])?$bits['path']:'')
425		- .(isset($bits['query'])?'?'.$bits['query']:'');
426		-
427		- if (strlen($url) > ($before+$after)) :
428		- $url = substr($url, 0, $before).'…'.substr($url, 0 - $after, $after);
429		- endif;
430		-
431		- return $url;
432		-}
433		-
434		-function get_syndication_source ($original = NULL, $id = NULL) {
435		- if (is_null($original)) :
436		- $original = FeedWordPress::use_aggregator_source_data();
437		- endif;
438		-
439		- if ($original) :
440		- $vals = get_post_custom_values('syndication_source_original', $id);
441		- else :
442		- $vals = array();
443		- endif;
444		-
445		- if (count($vals) == 0) :
446		- $vals = get_post_custom_values('syndication_source', $id);
447		- endif;
448		-
449		- if (count($vals) > 0) :
450		- $ret = $vals[0];
451		- else :
452		- $ret = NULL;
453		- endif;
454		-
455		- if (is_null($ret) or strlen(trim($ret)) == 0) :
456		- // Fall back to URL of blog
457		- $ret = feedwordpress_display_url(get_syndication_source_link());
458		- endif;
459		-
460		- return $ret;
461		-} /* function get_syndication_source() */
462		-
463		-function the_syndication_source ($original = NULL, $id = NULL) { echo get_syndication_source($original, $id); }
464		-
465		-function get_syndication_feed ($original = NULL, $id = NULL) {
466		- if (is_null($original)) : $original = FeedWordPress::use_aggregator_source_data();
467		- endif;
468		-
469		- if ($original) : $vals = get_post_custom_values('syndication_feed_original', $id);
470		- else : $vals = array();
471		- endif;
472		-
473		- if (count($vals) == 0) : $vals = get_post_custom_values('syndication_feed', $id);
474		- endif;
475		-
476		- if (count($vals) > 0) : $ret = $vals[0]; else : $ret = NULL; endif;
477		-
478		- return $ret;
479		-} /* function get_syndication_feed() */
480		-
481		-function the_syndication_feed ($original = NULL, $id = NULL) { echo get_syndication_feed($original, $id); }
482		-
483		-function get_syndication_feed_guid ($original = NULL, $id = NULL) {
484		- if (is_null($original)) : $original = FeedWordPress::use_aggregator_source_data();
485		- endif;
486		-
487		- if ($original) : $vals = get_post_custom_values('syndication_source_id_original', $id);
488		- else : $vals = array();
489		- endif;
490		-
491		- if (count($vals) == 0) : $vals = array(get_feed_meta('feed/id', $id));
492		- endif;
493		-
494		- if (count($vals) > 0) : $ret = $vals[0]; else : $ret = NULL; endif;
495		-
496		- return $ret;
497		-} /* function get_syndication_feed_guid () */
498		-
499		-function the_syndication_feed_guid ($original = NULL, $id = NULL) { echo get_syndication_feed_guid($original, $id); }
500		-
501		-function get_syndication_feed_id ($id = NULL) { list($u) = get_post_custom_values('syndication_feed_id', $id); return $u; }
502		-function the_syndication_feed_id ($id = NULL) { echo get_syndication_feed_id($id); }
503		-
504		-$feedwordpress_linkcache = array (); // only load links from database once
505		-
506		-function get_feed_meta ($key, $id = NULL) {
507		- global $wpdb, $feedwordpress_linkcache;
508		- $feed_id = get_syndication_feed_id($id);
509		-
510		- $ret = NULL;
511		- if (strlen($feed_id) > 0):
512		- if (isset($feedwordpress_linkcache[$feed_id])) :
513		- $link = $feedwordpress_linkcache[$feed_id];
514		- else :
515		- $link =& new SyndicatedLink($feed_id);
516		- $feedwordpress_linkcache[$feed_id] = $link;
	238	+function debug_out_feedwordpress_footer() {
	239	+ if ( FeedWordPressDiagnostic::is_on('memory_usage') ) :
	240	+ if ( function_exists('memory_get_usage') ) :
	241	+ FeedWordPress::diagnostic( 'memory_usage', "Memory: Current usage: " . size_format( memory_get_usage() ) );
517	242	endif;
518		-
519		- $ret = $link->settings[$key];
	243	+ if ( function_exists('memory_get_peak_usage') ) :
	244	+ FeedWordPress::diagnostic('memory_usage', "Memory: Peak usage: " . size_format( memory_get_peak_usage() ) );
	245	+ endif;
520	246	endif;
521		- return $ret;
522		-} /* get_feed_meta() */
	247	+} /* debug_out_feedwordpress_footer() */
523	248
524		-function get_syndication_permalink ($id = NULL) {
525		- list($u) = get_post_custom_values('syndication_permalink', $id); return $u;
526		-}
527		-function the_syndication_permalink ($id = NULL) {
528		- echo get_syndication_permalink($id);
529		-}
530		-
531	249	################################################################################
532	250	## FILTERS: syndication-aware handling of post data for templates and feeds ####
533	251	################################################################################
534	252
535		-$feedwordpress_the_syndicated_content = NULL;
	253	+$feedwordpress_the_syndicated_content = null;
	254	+$feedwordpress_the_original_permalink = null;
536	255
537	256	function feedwordpress_preserve_syndicated_content ($text) {
538	257	global $feedwordpress_the_syndicated_content;
539	258
540		- $globalExpose = (get_option('feedwordpress_formatting_filters') == 'yes');
541		- $localExpose = get_post_custom_values('_feedwordpress_formatting_filters');
542		- $expose = ($globalExpose or ((count($localExpose) > 0) and $localExpose[0]));
543		-
544		- if ( is_syndicated() and !$expose ) :
	259	+ $p = new FeedWordPressLocalPost;
	260	+ if ( ! $p->is_exposed_to_formatting_filters()) :
545	261	$feedwordpress_the_syndicated_content = $text;
546	262	else :
547		- $feedwordpress_the_syndicated_content = NULL;
	263	+ $feedwordpress_the_syndicated_content = null;
548	264	endif;
549	265	return $text;
550	266	}
551	267
		@@ -550,9 +266,9 @@
550	266	}
551	267
552	268	function feedwordpress_restore_syndicated_content ($text) {
553	269	global $feedwordpress_the_syndicated_content;
554		-
	270	+
555	271	if ( !is_null($feedwordpress_the_syndicated_content) ) :
556	272	$text = $feedwordpress_the_syndicated_content;
557	273	endif;
558	274
		@@ -563,21 +279,21 @@
563	279	// In a post context....
564	280	if (is_syndicated()) :
565	281	?>
566	282	<source>
567		- <title><?php print htmlspecialchars(get_syndication_source()); ?></title>
568		- <link rel="alternate" type="text/html" href="<?php print htmlspecialchars(get_syndication_source_link()); ?>" />
569		- <link rel="self" href="<?php print htmlspecialchars(get_syndication_feed()); ?>" />
	283	+ <title><?php print esc_html( get_syndication_source() ); ?></title>
	284	+ <link rel="alternate" type="text/html" href="<?php print esc_url( get_syndication_source_link() ); ?>" />
	285	+ <link rel="self" href="<?php print esc_url( get_syndication_feed() ); ?>" />
570	286	<?php
571	287	$id = get_syndication_feed_guid();
572		- if (strlen($id) > 0) :
	288	+ if ( strlen( $id ) > 0 ) :
573	289	?>
574		- <id><?php print htmlspecialchars($id); ?></id>
	290	+ <id><?php print esc_xml( $id ); ?></id>
575	291	<?php
576	292	endif;
577	293	$updated = get_feed_meta('feed/updated');
578		- if (strlen($updated) > 0) : ?>
579		- <updated><?php print $updated; ?></updated>
	294	+ if ( strlen( $updated ) > 0 ) : ?>
	295	+ <updated><?php print esc_xml( $updated ); ?></updated>
580	296	<?php
581	297	endif;
582	298	?>
583	299	</source>
		@@ -584,264 +300,160 @@
584	300	<?php
585	301	endif;
586	302	}
587	303
588		-function syndication_permalink ($permalink = '') {
589		- if (get_option('feedwordpress_munge_permalink') != 'no'):
590		- $uri = get_syndication_permalink();
591		- return ((strlen($uri) > 0) ? $uri : $permalink);
592		- else:
593		- return $permalink;
594		- endif;
595		-} // function syndication_permalink ()
	304	+/**
	305	+ * syndication_permalink: Allow WordPress to use the original remote URL of
	306	+ * syndicated posts as their permalink. Can be turned on or off by by setting in
	307	+ * Syndication => Posts & Links. Saves the old internal permalink in a global
	308	+ * variable for later use.
	309	+ *
	310	+ * @param string $permalink The internal permalink
	311	+ * @param mixed|null $post Post object
	312	+ * @param bool $leavename Unused
	313	+ * @param bool $sample Unused
	314	+ * @return string The new permalink. Same as the old if the post is not
	315	+ * syndicated, or if FWP is set to use internal permalinks, or if the post
	316	+ * was syndicated, but didn't have a proper permalink recorded.
	317	+ *
	318	+ * @uses SyndicatedLink::setting()
	319	+ * @uses get_syndication_permalink()
	320	+ * @uses get_syndication_feed_object()
	321	+ * @uses url_to_postid()
	322	+ * @global $id
	323	+ * @global $feedwordpress_the_original_permalink
	324	+ */
	325	+function syndication_permalink($permalink = '', $post = null, $leavename = false, $sample = false ) {
	326	+ global $id;
	327	+ global $feedwordpress_the_original_permalink;
596	328
597		-################################################################################
598		-## ADMIN MENU ADD-ONS: register Dashboard management pages #####################
599		-################################################################################
	329	+ // Save the local permalink in case we need to retrieve it later.
	330	+ $feedwordpress_the_original_permalink = $permalink;
600	331
601		-function fwp_add_pages () {
602		- global $fwp_capability;
603		- global $fwp_path;
	332	+ if (is_object($post) and isset($post->ID) and !empty($post->ID)) :
	333	+ // Use the post ID we've been provided with.
	334	+ $postId = $post->ID;
	335	+ elseif (is_string($permalink) and strlen($permalink) > 0) :
	336	+ // Map this permalink to a post ID so we can get the correct
	337	+ // permalink even outside of the Post Loop. Props Björn.
	338	+ $postId = url_to_postid($permalink);
	339	+ else :
	340	+ // If the permalink string is empty but Post Loop context
	341	+ // provides an id.
	342	+ $postId = $id;
	343	+ endif;
604	344
605		- $menu = array('Syndicated Sites', 'Syndication', $fwp_capability['manage_links'], $fwp_path.'/syndication.php', NULL);
606		- if (fwp_test_wp_version(FWP_SCHEMA_27)) :
607		- // add icon parameter
608		- $menu[] = WP_PLUGIN_URL.'/'.$fwp_path.'/feedwordpress-tiny.png';
	345	+ $munge = false;
	346	+ $link = get_syndication_feed_object($postId);
	347	+ if (is_object($link)) :
	348	+ $munge = ($link->setting('munge permalink', 'munge_permalink', 'yes') != 'no');
609	349	endif;
610	350
611		- call_user_func_array('add_menu_page', $menu);
612		- add_submenu_page($fwp_path.'/syndication.php', 'Syndicated Feeds & Updates', 'Feeds & Updates', $fwp_capability['manage_options'], $fwp_path.'/feeds-page.php');
613		- add_submenu_page($fwp_path.'/syndication.php', 'Syndicated Posts & Links', 'Posts & Links', $fwp_capability['manage_options'], $fwp_path.'/posts-page.php');
614		- add_submenu_page($fwp_path.'/syndication.php', 'Syndicated Authors', 'Authors', $fwp_capability['manage_options'], $fwp_path.'/authors-page.php');
615		- add_submenu_page($fwp_path.'/syndication.php', 'Categories'.FEEDWORDPRESS_AND_TAGS, 'Categories'.FEEDWORDPRESS_AND_TAGS, $fwp_capability['manage_options'], $fwp_path.'/categories-page.php');
616		- add_submenu_page($fwp_path.'/syndication.php', 'FeedWordPress Back End', 'Back End', $fwp_capability['manage_options'], $fwp_path.'/backend-page.php');
617		-} /* function fwp_add_pages () */
	351	+ if ($munge):
	352	+ $uri = get_syndication_permalink($postId);
	353	+ $permalink = ((strlen($uri) > 0) ? $uri : $permalink);
	354	+ endif;
	355	+ return $permalink;
	356	+} /* function syndication_permalink () */
618	357
619		-function fwp_check_debug () {
620		- // This is a horrible fucking kludge that I have to do because the
621		- // admin notice code is triggered before the code that updates the
622		- // setting.
623		- if (isset($_POST['feedwordpress_debug'])) :
624		- $feedwordpress_debug = $_POST['feedwordpress_debug'];
625		- else :
626		- $feedwordpress_debug = get_option('feedwordpress_debug');
	358	+/**
	359	+ * syndication_permalink_escaped: Escape XML special characters in syndicated
	360	+ * permalinks when used in feed contexts and HTML display contexts.
	361	+ *
	362	+ * @param string $permalink
	363	+ * @return string
	364	+ *
	365	+ * @uses is_syndicated()
	366	+ * @uses FeedWordPress::munge_permalinks()
	367	+ *
	368	+ */
	369	+function syndication_permalink_escaped ($permalink) {
	370	+ /* FIXME: This should review link settings not just global settings */
	371	+ if (is_syndicated() and FeedWordPress::munge_permalinks()) :
	372	+ // This is a foreign link; WordPress can't vouch for its not
	373	+ // having any entities that need to be &-escaped. So we'll do
	374	+ // it here.
	375	+ $permalink = esc_html($permalink);
627	376	endif;
628		- if ($feedwordpress_debug==='yes') :
629		-?>
630		- <div class="error">
631		-<p><strong>FeedWordPress warning.</strong> Debugging mode is <strong>ON</strong>.
632		-While it remains on, FeedWordPress displays many diagnostic error messages,
633		-warnings, and notices that are ordinarily suppressed, and also turns off all
634		-caching of feeds. Use with caution: this setting is absolutely inappropriate
635		-for a production server.</p>
636		- </div>
637		-<?php
638		- endif;
639		-} /* function fwp_check_debug () */
	377	+ return $permalink;
	378	+} /* function syndication_permalink_escaped() */
640	379
641		-define('EXPECTED_MAGPIE_VERSION', '2010.0122');
642		-function fwp_check_magpie () {
643		- if (isset($_REQUEST['feedwordpress_magpie_fix'])) :
644		- if ($_REQUEST['feedwordpress_magpie_fix']=='ignored') :
645		-?>
646		-<div class="updated fade">
647		-<p>O.K., we'll ignore the problem for now. FeedWordPress will not display any
648		-more error messages.</p>
649		-</div>
650		-<?php
651		- elseif ((bool) $_REQUEST['feedwordpress_magpie_fix']) :
652		-?>
653		-<div class="updated fade">
654		-<p>Congratulations! Your MagpieRSS has been successfully upgraded to the version
655		-shipped with FeedWordPress.</p>
656		-</div>
657		-<?php
658		- else :
659		- $source = dirname(__FILE__)."/MagpieRSS-upgrade/rss.php";
660		- $destination = ABSPATH . WPINC . '/rss.php';
661		- $cmd = "cp '".htmlspecialchars(addslashes($source))."' '".htmlspecialchars(addslashes($destination))."'";
662		- $cmd = wordwrap($cmd, /*width=*/ 75, /*break=*/ " \\\n\t");
	380	+/**
	381	+ * syndication_comments_feed_link: Escape XML special characters in comments
	382	+ * feed links
	383	+ *
	384	+ * @param string $link
	385	+ * @return string
	386	+ *
	387	+ * @uses is_syndicated()
	388	+ * @uses FeedWordPress::munge_permalinks()
	389	+ */
	390	+function syndication_comments_feed_link ($link) {
	391	+ global $feedwordpress_the_original_permalink;
663	392
664		-?>
665		-<div class="error">
666		-<p><strong>FeedWordPress was unable to automatically upgrade your copy of MagpieRSS.</strong></p>
667		-<p>It's likely that you need to change the file permissions on <code><?php print htmlspecialchars($source); ?></code>
668		-to allow FeedWordPress to overwrite it.</p>
669		-<p><strong>To perform the upgrade manually,</strong> you can
670		-use a SFTP or FTP client to upload a copy of <code>rss.php</code> from the
671		-<code>MagpieRSS-upgrades/</code> directory of your FeedWordPress archive so that
672		-it overwrites <code><?php print htmlspecialchars($destination); ?></code>. Or,
673		-if your web host provides shell access, you can issue the following command from
674		-a command prompt to perform the upgrade:</p>
675		-<pre>
676		-<samp>$</samp> <kbd><?php print $cmd; ?></kbd>
677		-</pre>
678		-<p><strong>If you've fixed the file permissions,</strong> you can try the
679		-automatic upgrade again.</p>
	393	+ if (is_syndicated() and FeedWordPress::munge_permalinks()) :
	394	+ // If the source post provided a comment feed URL using
	395	+ // wfw:commentRss or atom:link/@rel="replies" we can make use of
	396	+ // that value here.
	397	+ $source = get_syndication_feed_object();
	398	+ $replacement = null;
680	399
681		-<?php feedwordpress_upgrade_old_and_busted_buttons(); ?>
682		-</div>
683		-<?php
684		- endif;
685		- else :
686		- $magpie_version = FeedWordPress::magpie_version();
	400	+ if (is_object($source) && $source->setting('munge comments feed links', 'munge_comments_feed_links', 'yes') != 'no') :
	401	+ $commentFeeds = get_post_custom_values('wfw:commentRSS');
	402	+ if (
	403	+ is_array($commentFeeds)
	404	+ and (count($commentFeeds) > 0)
	405	+ and (strlen($commentFeeds[0]) > 0)
	406	+ ) :
	407	+ $replacement = $commentFeeds[0];
687	408
688		- $ignored = get_option('feedwordpress_magpie_ignored_upgrade_to');
689		- if (EXPECTED_MAGPIE_VERSION != $magpie_version and EXPECTED_MAGPIE_VERSION != $ignored) :
690		- if (current_user_can('edit_files')) :
691		- $youAre = 'you are';
692		- $itIsRecommendedThatYou = 'It is <strong>strongly recommended</strong> that you';
693		- else :
694		- $youAre = 'this site is';
695		- $itIsRecommendedThatYou = 'You may want to contact the administrator of the site; it is <strong>strongly recommended</strong> that they';
	409	+ // This is a foreign link; WordPress can't vouch for its not
	410	+ // having any entities that need to be &-escaped. So we'll do it
	411	+ // here.
	412	+ $replacement = esc_html($replacement);
696	413	endif;
697		- print '<div class="error">';
698		-?>
699		-<p style="font-style: italic"><strong>FeedWordPress has detected that <?php print $youAre; ?> currently using a version of
700		-MagpieRSS other than the upgraded version that ships with this version of FeedWordPress.</strong></p>
701		-<ul>
702		-<li><strong>Currently running:</strong> MagpieRSS <?php print $magpie_version; ?></li>
703		-<li><strong>Version included with FeedWordPress <?php print FEEDWORDPRESS_VERSION; ?>:</strong> MagpieRSS <?php print EXPECTED_MAGPIE_VERSION; ?></li>
704		-</ul>
705		-<p><?php print $itIsRecommendedThatYou; ?> install the upgraded
706		-version of MagpieRSS supplied with FeedWordPress. The version of
707		-MagpieRSS that ships with WordPress is very old and buggy, and
708		-encounters a number of errors when trying to parse modern Atom
709		-and RSS feeds.</p>
710		-<?php
711		- feedwordpress_upgrade_old_and_busted_buttons();
712		- print '</div>';
713	414	endif;
714		- endif;
715		-}
716	415
717		-function feedwordpress_upgrade_old_and_busted_buttons() {
718		- if (current_user_can('edit_files')) :
719		-?>
720		-<form action="" method="post"><div>
721		-<?php FeedWordPressCompatibility::stamp_nonce('feedwordpress_fix_magpie'); ?>
722		-<input type="hidden" name="action" value="fix_magpie_version" />
723		-<input class="button-secondary" type="submit" name="ignore" value="<?php _e('Ignore this problem'); ?>" />
724		-<input class="button-primary" type="submit" name="upgrade" value="<?php _e('Upgrade'); ?>" />
725		-</div></form>
726		-<?php
727		- endif;
728		-}
	416	+ if (is_null($replacement)) :
	417	+ // Q: How can we get the proper feed format, since the
	418	+ // format is, stupidly, not passed to the filter?
	419	+ // A: Kludge kludge kludge kludge!
	420	+ $fancy_permalinks = ('' != get_option('permalink_structure'));
	421	+ if ($fancy_permalinks) :
	422	+ preg_match('|/feed(/([^/]+))?/?$|', $link, $ref);
729	423
730		-################################################################################
731		-## fwp_hold_pings() and fwp_release_pings(): Outbound XML-RPC ping reform ####
732		-## ... 'coz it's rude to send 500 pings the first time your aggregator runs ####
733		-################################################################################
	424	+ $format = (isset($ref[2]) ? $ref[2] : '');
	425	+ if (strlen($format) == 0) : $format = get_default_feed(); endif;
734	426
735		-$fwp_held_ping = NULL; // NULL: not holding pings yet
736		-
737		-function fwp_hold_pings () {
738		- global $fwp_held_ping;
739		- if (is_null($fwp_held_ping)):
740		- $fwp_held_ping = 0; // 0: ready to hold pings; none yet received
741		- endif;
742		-}
743		-
744		-function fwp_release_pings () {
745		- global $fwp_held_ping;
746		- if ($fwp_held_ping):
747		- if (function_exists('wp_schedule_single_event')) :
748		- wp_schedule_single_event(time(), 'do_pings');
749		- else :
750		- generic_ping($fwp_held_ping);
	427	+ $replacement = trailingslashit($feedwordpress_the_original_permalink) . 'feed';
	428	+ if ($format != get_default_feed()) :
	429	+ $replacement .= '/'.$format;
	430	+ endif;
	431	+ $replacement = user_trailingslashit($replacement, 'single_feed');
	432	+ else :
	433	+ // No fancy permalinks = no problem
	434	+ // WordPress doesn't call get_permalink() to
	435	+ // generate the comment feed URL, so the
	436	+ // comments feed link is never munged by FWP.
	437	+ endif;
751	438	endif;
752		- endif;
753		- $fwp_held_ping = NULL; // NULL: not holding pings anymore
754		-}
755	439
756		-function fwp_do_pings () {
757		- if (!is_null($fwp_held_ping) and $post_id) : // Defer until we're done updating
758		- $fwp_held_ping = $post_id;
759		- elseif (function_exists('do_all_pings')) :
760		- do_all_pings();
761		- else :
762		- generic_ping($fwp_held_ping);
	440	+ if ( !is_null($replacement)) : $link = $replacement; endif;
763	441	endif;
764		-}
	442	+ return $link;
	443	+} /* function syndication_comments_feed_link() */
765	444
766		-function fwp_publish_post_hook ($post_id) {
767		- global $fwp_held_ping;
	445	+ require_once("{$dir}/feedwordpress.pings.functions.php");
768	446
769		- if (!is_null($fwp_held_ping)) : // Syndicated post. Don't mark with _pingme
770		- if ( defined('XMLRPC_REQUEST') )
771		- do_action('xmlrpc_publish_post', $post_id);
772		- if ( defined('APP_REQUEST') )
773		- do_action('app_publish_post', $post_id);
774		-
775		- if ( defined('WP_IMPORTING') )
776		- return;
	447	+ require_once("{$dir}/feedwordpress.wp-admin.post-edit.functions.php");
777	448
778		- // Defer sending out pings until we finish updating
779		- $fwp_held_ping = $post_id;
780		- else :
781		- if (function_exists('_publish_post_hook')) : // WordPress 2.3
782		- _publish_post_hook($post_id);
783		- endif;
784		- endif;
785		-}
	449	+################################################################################
	450	+## class FeedWordPressBoilerplateReformatter ###################################
	451	+################################################################################
786	452
787		- function feedwordpress_add_post_edit_controls () {
788		- add_meta_box('feedwordpress-post-controls', __('Syndication'), 'feedwordpress_post_edit_controls', 'post', 'side', 'high');
789		- } // function FeedWordPress::postEditControls
790		-
791		- function feedwordpress_post_edit_controls () {
792		- global $post;
793		-
794		- $frozen_values = get_post_custom_values('_syndication_freeze_updates', $post->ID);
795		- $frozen_post = (count($frozen_values) > 0 and 'yes' == $frozen_values[0]);
	453	+require_once("{$dir}/feedwordpressboilerplatereformatter.class.php");
	454	+require_once("{$dir}/feedwordpressboilerplatereformatter.shortcode.functions.php");
796	455
797		- if (is_syndicated($post->ID)) :
798		- ?>
799		- <p>This is a syndicated post, which originally appeared at
800		- <cite><?php print wp_specialchars(get_syndication_source(NULL, $post->ID)); ?></cite>.
801		- <a href="<?php print wp_specialchars(get_syndication_permalink($post->ID)); ?>">View original post</a>.</p>
802		-
803		- <p><input type="hidden" name="feedwordpress_noncename" id="feedwordpress_noncename" value="<?php print wp_create_nonce(plugin_basename(__FILE__)); ?>" />
804		- <label><input type="checkbox" name="freeze_updates" value="yes" <?php if ($frozen_post) : ?>checked="checked"<?php endif; ?> /> <strong>Manual editing.</strong>
805		- If set, FeedWordPress will not overwrite the changes you make manually
806		- to this post, if the syndicated content is updated on the
807		- feed.</label></p>
808		- <?php
809		- else :
810		- ?>
811		- <p>This post was created locally at this website.</p>
812		- <?php
813		- endif;
814		- } // function feedwordpress_post_edit_controls () */
815		-
816		- function feedwordpress_save_post_edit_controls ( $post_id ) {
817		- global $post;
818		-
819		- if (!isset($_POST['feedwordpress_noncename']) or !wp_verify_nonce($_POST['feedwordpress_noncename'], plugin_basename(__FILE__))) :
820		- return $post_id;
821		- endif;
822		-
823		- // Verify if this is an auto save routine. If it is our form has
824		- // not been submitted, so we don't want to do anything.
825		- if ( defined('DOING_AUTOSAVE') and DOING_AUTOSAVE ) :
826		- return $post_id;
827		- endif;
828		-
829		- // Check permissions
830		- if ( !current_user_can( 'edit_'.$_POST['post_type'], $post_id) ) :
831		- return $post_id;
832		- endif;
833		-
834		- // OK, we're golden. Now let's save some data.
835		- if (isset($_POST['freeze_updates'])) :
836		- update_post_meta($post_id, '_syndication_freeze_updates', $_POST['freeze_updates']);
837		- else :
838		- delete_post_meta($post_id, '_syndication_freeze_updates');
839		- endif;
840		-
841		- return $_POST['freeze_updates'];
842		- } // function feedwordpress_save_edit_controls
843		-
844	456	################################################################################
845	457	## class FeedWordPress #########################################################
846	458	################################################################################
847	459
		@@ -878,143 +490,570 @@
878	490	array('q', 'cite'),
879	491	array('script', 'src')
880	492	);
881	493
882		- var $feeds = NULL;
	494	+ var $feeds = null;
	495	+ var $feedurls = null;
	496	+ var $httpauth = null;
883	497
884		- # function FeedWordPress (): Contructor; retrieve a list of feeds
885		- function FeedWordPress () {
	498	+ /**
	499	+ * FeedWordPress::__construct (): Construct FeedWordPress singleton object
	500	+ * and retrieves a list of feeds for later reference.
	501	+ *
	502	+ * @uses FeedWordPressHTTPAuthenticator
	503	+ */
	504	+ public function __construct () {
886	505	$this->feeds = array ();
	506	+ $this->feedurls = array();
887	507	$links = FeedWordPress::syndicated_links();
	508	+
888	509	if ($links): foreach ($links as $link):
889		- $this->feeds[] =& new SyndicatedLink($link);
	510	+ $id = intval($link->link_id);
	511	+ $url = $link->link_rss;
	512	+
	513	+ // Store for later reference.
	514	+ $this->feeds[$id] = $id;
	515	+ if (strlen($url) > 0) :
	516	+ $this->feedurls[$url] = $id;
	517	+ endif;
890	518	endforeach; endif;
891		- } // FeedWordPress::FeedWordPress ()
892	519
893		- # function update (): polls for updates on one or more Contributor feeds
894		- #
	520	+ // System-related event hooks
	521	+ add_filter('cron_schedules', array($this, 'cron_schedules'), 10, 1);
	522	+
	523	+ // FeedWordPress-related event hooks
	524	+ add_filter('feedwordpress_update_complete', array($this, 'process_retirements'), 1000, 1);
	525	+
	526	+ $this->httpauth = new FeedWordPressHTTPAuthenticator;
	527	+ } /* FeedWordPress::__construct () */
	528	+
	529	+ /**
	530	+ * FeedWordPress::add_filters() connects FeedWordPress to WordPress lifecycle
	531	+ * events by setting up action and filter hooks.
	532	+ *
	533	+ * @uses get_option()
	534	+ * @uses add_filter()
	535	+ * @uses add_action()
	536	+ * @uses remove_filter()
	537	+ */
	538	+ public function add_filters () {
	539	+ # Syndicated items are generally received in output-ready (X)HTML and
	540	+ # should not be folded, crumpled, mutilated, or spindled by WordPress
	541	+ # formatting filters. But we don't want to interfere with filters for
	542	+ # any locally-authored posts, either.
	543	+ #
	544	+ # What WordPress should really have is a way for upstream filters to
	545	+ # stop downstream filters from running at all. Since it doesn't, and
	546	+ # since a downstream filter can't access the original copy of the text
	547	+ # that is being filtered, what we will do here is (1) save a copy of the
	548	+ # original text upstream, before any other filters run, and then (2)
	549	+ # retrieve that copy downstream, after all the other filters run, *if*
	550	+ # this is a syndicated post
	551	+
	552	+ add_filter('the_content', 'feedwordpress_preserve_syndicated_content', -10000);
	553	+ add_filter('the_content', 'feedwordpress_restore_syndicated_content', 10000);
	554	+
	555	+ add_action('atom_entry', 'feedwordpress_item_feed_data');
	556	+
	557	+ # Filter in original permalinks if the user wants that
	558	+ add_filter('post_link', 'syndication_permalink', /*priority=*/ 1, /*arguments=*/ 3);
	559	+ add_filter('post_type_link', 'syndication_permalink', /*priority=*/ 1, /*arguments=*/ 4);
	560	+
	561	+ # When foreign URLs are used for permalinks in feeds or display
	562	+ # contexts, they need to be escaped properly.
	563	+ add_filter('the_permalink', 'syndication_permalink_escaped');
	564	+ add_filter('the_permalink_rss', 'syndication_permalink_escaped');
	565	+
	566	+ add_filter('post_comments_feed_link', 'syndication_comments_feed_link');
	567	+
	568	+ # WTF? By default, wp_insert_link runs incoming link_url and link_rss
	569	+ # URIs through default filters that include `wp_kses()`. But `wp_kses()`
	570	+ # just happens to escape any occurrence of & to &amp; -- which just
	571	+ # happens to fuck up any URI with a & to separate GET parameters.
	572	+ remove_filter('pre_link_rss', 'wp_filter_kses');
	573	+ remove_filter('pre_link_url', 'wp_filter_kses');
	574	+
	575	+ # Boilerplate functionality: hook in to title, excerpt, and content to add boilerplate text
	576	+ $hookOrder = get_option('feedwordpress_boilerplate_hook_order', FEEDWORDPRESS_BOILERPLATE_DEFAULT_HOOK_ORDER);
	577	+ add_filter(
	578	+ /*hook=*/ 'the_title',
	579	+ /*function=*/ 'add_boilerplate_title',
	580	+ /*priority=*/ $hookOrder,
	581	+ /*arguments=*/ 2
	582	+ );
	583	+ add_filter(
	584	+ /*hook=*/ 'get_the_excerpt',
	585	+ /*function=*/ 'add_boilerplate_excerpt',
	586	+ /*priority=*/ $hookOrder,
	587	+ /*arguments=*/ 1
	588	+ );
	589	+ add_filter(
	590	+ /*hook=*/ 'the_content',
	591	+ /*function=*/ 'add_boilerplate_content',
	592	+ /*priority=*/ $hookOrder,
	593	+ /*arguments=*/ 1
	594	+ );
	595	+ add_filter(
	596	+ /*hook=*/ 'the_content_rss',
	597	+ /*function=*/ 'add_boilerplate_content',
	598	+ /*priority=*/ $hookOrder,
	599	+ /*arguments=*/ 1
	600	+ );
	601	+
	602	+ # Admin menu
	603	+ add_action('admin_init', array($this, 'admin_init'));
	604	+ add_action('admin_menu', array($this, 'add_pages'));
	605	+ add_action('admin_notices', array($this, 'check_debug'));
	606	+
	607	+ add_action('admin_menu', 'feedwordpress_add_post_edit_controls');
	608	+ add_action('save_post', 'feedwordpress_save_post_edit_controls');
	609	+
	610	+ add_action('admin_footer', array($this, 'admin_footer'));
	611	+
	612	+ add_action('syndicated_feed_error', array('FeedWordPressDiagnostic', 'feed_error'), 100, 3);
	613	+
	614	+ add_action('wp_footer', 'debug_out_feedwordpress_footer', -100);
	615	+ add_action('admin_footer', 'debug_out_feedwordpress_footer', -100);
	616	+
	617	+ # Cron-less auto-update. Hooray!
	618	+ $autoUpdateHook = $this->automatic_update_hook();
	619	+ if ( !is_null($autoUpdateHook)) :
	620	+ add_action($autoUpdateHook, array($this, 'auto_update'));
	621	+ endif;
	622	+
	623	+ add_action('init', array($this, 'init'));
	624	+ add_action('wp_loaded', array($this, 'wp_loaded'));
	625	+
	626	+ add_action('shutdown', array($this, 'email_diagnostic_log'));
	627	+ add_action('shutdown', array($this, 'feedwordpress_cleanup'));
	628	+ add_action('wp_dashboard_setup', array($this, 'dashboard_setup'));
	629	+
	630	+ # Default sanitizers
	631	+ add_filter('syndicated_item_content', array('SyndicatedPost', 'resolve_relative_uris'), 0, 2);
	632	+ add_filter('syndicated_item_content', array('SyndicatedPost', 'sanitize_content'), 0, 2);
	633	+
	634	+ add_action('plugins_loaded', array($this, 'admin_api'));
	635	+ add_action('all_admin_notices', array($this, 'all_admin_notices'));
	636	+
	637	+ // Use the cache settings that we want, from a static method
	638	+ add_filter('wp_feed_cache_transient_lifetime', array(get_class($this), 'cache_lifetime'));
	639	+
	640	+ } /* FeedWordPress::add_filters () */
	641	+
	642	+ ################################################################################
	643	+ ## ADMIN MENU ADD-ONS: register Dashboard management pages #####################
	644	+ ################################################################################
	645	+
	646	+ /**
	647	+ * FeedWordPress::add_pages(): set up WordPress admin interface pages thru
	648	+ * hooking in Syndication menu and submenus
	649	+ *
	650	+ * @uses FeedWordPress::menu_cap()
	651	+ * @uses FeedWordPress::path()
	652	+ * @uses add_menu_page()
	653	+ * @uses add_submenu_page()
	654	+ * @uses do_action()
	655	+ * @uses add_filter()
	656	+ */
	657	+ public function add_pages()
	658	+ {
	659	+ $menu_cap = FeedWordPress::menu_cap();
	660	+ $settings_cap = FeedWordPress::menu_cap( /*sub=*/ true );
	661	+ $syndicationMenu = FeedWordPress::path( 'syndication.php' );
	662	+
	663	+ add_menu_page(
	664	+ /* page_title */ 'Syndicated Sites',
	665	+ /* menu_title */ 'Syndication',
	666	+ /* capability */ $menu_cap,
	667	+ /* menu_slug */ $syndicationMenu,
	668	+ /* function */ NULL,
	669	+ /* icon_url */ $this->plugin_dir_url( /* 'assets/images/feedwordpress-tiny.png' */ 'assets/images/icon.svg' )
	670	+ /* position */
	671	+ );
	672	+
	673	+ do_action( 'feedwordpress_admin_menu_pre_feeds', $menu_cap, $settings_cap );
	674	+ add_submenu_page(
	675	+ /* parent_slug */ $syndicationMenu,
	676	+ /* page_title */ 'Syndicated Sites',
	677	+ /* menu_title */ 'Syndicated Sites',
	678	+ /* capability */ $settings_cap,
	679	+ /* menu_slug */ $syndicationMenu,
	680	+ /* function */
	681	+ );
	682	+
	683	+ do_action('feedwordpress_admin_menu_pre_feeds', $menu_cap, $settings_cap);
	684	+ add_submenu_page(
	685	+ $syndicationMenu, 'Syndicated Feeds & Updates', 'Feeds & Updates',
	686	+ $settings_cap, FeedWordPress::path('feeds-page.php')
	687	+ );
	688	+
	689	+ do_action('feedwordpress_admin_menu_pre_posts', $menu_cap, $settings_cap);
	690	+ add_submenu_page(
	691	+ $syndicationMenu, 'Syndicated Posts & Links', 'Posts & Links',
	692	+ $settings_cap, FeedWordPress::path('posts-page.php')
	693	+ );
	694	+
	695	+ do_action('feedwordpress_admin_menu_pre_authors', $menu_cap, $settings_cap);
	696	+ add_submenu_page(
	697	+ $syndicationMenu, 'Syndicated Authors', 'Authors',
	698	+ $settings_cap, FeedWordPress::path('authors-page.php')
	699	+ );
	700	+
	701	+ do_action('feedwordpress_admin_menu_pre_categories', $menu_cap, $settings_cap);
	702	+ add_submenu_page(
	703	+ $syndicationMenu, 'Categories & Tags', 'Categories & Tags',
	704	+ $settings_cap, FeedWordPress::path('categories-page.php')
	705	+ );
	706	+
	707	+ do_action('feedwordpress_admin_menu_pre_performance', $menu_cap, $settings_cap);
	708	+ add_submenu_page(
	709	+ $syndicationMenu, 'FeedWordPress Performance', 'Performance',
	710	+ $settings_cap, FeedWordPress::path('performance-page.php')
	711	+ );
	712	+
	713	+ do_action('feedwordpress_admin_menu_pre_diagnostics', $menu_cap, $settings_cap);
	714	+ add_submenu_page(
	715	+ $syndicationMenu, 'FeedWordPress Diagnostics', 'Diagnostics',
	716	+ $settings_cap, FeedWordPress::path('diagnostics-page.php')
	717	+ );
	718	+
	719	+ add_filter('page_row_actions', array($this, 'row_actions'), 10, 2);
	720	+ add_filter('post_row_actions', array($this, 'row_actions'), 10, 2);
	721	+ } /* function FeedWordPress::add_pages () */
	722	+
	723	+ public function check_debug() {
	724	+ // This is a horrible fucking kludge that I have to do because the
	725	+ // admin notice code is triggered before the code that updates the
	726	+ // setting.
	727	+ $feedwordpress_debug = FeedWordPress::param( 'feedwordpress_debug', get_option( 'feedwordpress_debug' ) );
	728	+
	729	+ FeedWordPressSettingsUI::get_template_part( 'notice-debug-mode', $feedwordpress_debug, 'html' );
	730	+ } /* function FeedWordPress::check_debug () */
	731	+
	732	+ /**
	733	+ * FeedWordPress::subscribed (): Check whether a feed is currently in the
	734	+ * subscription list for FeedWordPress.
	735	+ *
	736	+ * @param mixed $id Numeric ID of a WordPress link object or URL of a feed
	737	+ * @return bool TRUE if currently subscribed; FALSE otherwise.
	738	+ */
	739	+ public function subscribed ($id) {
	740	+ return (isset($this->feedurls[$id]) or isset($this->feeds[$id]));
	741	+ } /* FeedWordPress::subscribed () */
	742	+
	743	+ /**
	744	+ * FeedWordPress::subscription (): Get the SyndicatedLink object for a
	745	+ * given URL or numeric ID, if we have either an active subscription to
	746	+ * it; or a de-activated subscription.
	747	+ *
	748	+ * @param mixed $which Numeric ID for a WordPress link object or string URL for a feed
	749	+ * @return mixed SyndicatedLink object if subscription is found; null if not
	750	+ */
	751	+ public function subscription ($which) {
	752	+ $sub = null;
	753	+
	754	+ if (is_string($which) and isset($this->feedurls[$which])) :
	755	+ $which = $this->feedurls[$which];
	756	+ endif;
	757	+
	758	+ if (isset($this->feeds[$which])) :
	759	+ $sub = $this->feeds[$which];
	760	+ endif;
	761	+
	762	+ // If it's not in the in-memory cache already, try to load it from DB.
	763	+ // This is necessary to fill requests for subscriptions that we don't
	764	+ // cache in memory, e.g. for deactivated feeds.
	765	+ if (is_null($sub)) :
	766	+ $sub = get_bookmark($which);
	767	+ endif;
	768	+
	769	+ // Load 'er up if you haven't already.
	770	+ if ( !is_null($sub) and !($sub InstanceOf SyndicatedLink)) :
	771	+ $link = new SyndicatedLink($sub);
	772	+ $this->feeds[$which] = $link;
	773	+ $sub = $link;
	774	+ endif;
	775	+
	776	+ return $sub;
	777	+ } /* FeedWordPress::subscription () */
	778	+
	779	+ /** function update (): polls for updates on one or more Contributor feeds
	780	+
	781	+ @desc
895	782	# Arguments:
896		- # ----------
897		- # * $uri (string): either the URI of the feed to poll, the URI of the
898		- # (human-readable) website whose feed you want to poll, or NULL.
899		- #
900		- # If $uri is NULL, then FeedWordPress will poll any feeds that are
901		- # ready for polling. It will not poll feeds that are marked as
902		- # "Invisible" Links (signifying that the subscription has been
903		- # de-activated), or feeds that are not yet stale according to their
904		- # TTL setting (which is either set in the feed, or else set
905		- # randomly within a window of 30 minutes - 2 hours).
906		- #
	783	+
	784	+ - $uri (string): Either the URI of the feed to poll, the URI of the
	785	+ (human-readable) website whose feed you want to poll, or null.
	786	+
	787	+ If $uri is null, then FeedWordPress will poll any feeds that are
	788	+ ready for polling. It will not poll feeds that are marked as
	789	+ "Invisible" Links (signifying that the subscription has been
	790	+ de-activated), or feeds that are not yet stale according to their
	791	+ TTL setting (which is either set in the feed, or else set
	792	+ randomly within a window of 30 minutes - 2 hours).
	793	+
907	794	# Returns:
908		- # --------
909		- # * Normally returns an associative array, with 'new' => the number
910		- # of new posts added during the update, and 'updated' => the number
911		- # of old posts that were updated during the update. If both numbers
912		- # are zero, there was no change since the last poll on that URI.
913		- #
914		- # * Returns NULL if URI it was passed was not a URI that this
915		- # installation of FeedWordPress syndicates.
916		- #
	795	+
	796	+ - Normally returns an associative array, with 'new' => the number
	797	+ of new posts added during the update, and 'updated' => the number
	798	+ of old posts that were updated during the update. If both numbers
	799	+ are zero, there was no change since the last poll on that URI.
	800	+
	801	+ - Returns null if URI it was passed was not a URI that this
	802	+ installation of FeedWordPress syndicates.
	803	+
917	804	# Effects:
918		- # --------
919		- # * One or more feeds are polled for updates
920		- #
921		- # * If the feed Link does not have a hardcoded name set, its Link
922		- # Name is synchronized with the feed's title element
923		- #
924		- # * If the feed Link does not have a hardcoded URI set, its Link URI
925		- # is synchronized with the feed's human-readable link element
926		- #
927		- # * If the feed Link does not have a hardcoded description set, its
928		- # Link Description is synchronized with the feed's description,
929		- # tagline, or subtitle element.
930		- #
931		- # * The time of polling is recorded in the feed's settings, and the
932		- # TTL (time until the feed is next available for polling) is set
933		- # either from the feed (if it is supplied in the ttl or syndication
934		- # module elements) or else from a randomly-generated time window
935		- # (between 30 minutes and 2 hours).
936		- #
937		- # * New posts from the polled feed are added to the WordPress store.
938		- #
939		- # * Updates to existing posts since the last poll are mirrored in the
940		- # WordPress store.
941		- #
942		- function update ($uri = null, $crash_ts = null) {
943		- global $wpdb;
944	805
945		- if (FeedWordPress::needs_upgrade()) : // Will make duplicate posts if we don't hold off
946		- return NULL;
	806	+ - One or more feeds are polled for updates
	807	+
	808	+ - If the feed Link does not have a hardcoded name set, its Link
	809	+ Name is synchronized with the feed's title element
	810	+
	811	+ - If the feed Link does not have a hardcoded URI set, its Link URI
	812	+ is synchronized with the feed's human-readable link element
	813	+
	814	+ - If the feed Link does not have a hardcoded description set, its
	815	+ Link Description is synchronized with the feed's description,
	816	+ tagline, or subtitle element.
	817	+
	818	+ - The time of polling is recorded in the feed's settings, and the
	819	+ TTL (time until the feed is next available for polling) is set
	820	+ either from the feed (if it is supplied in the ttl or syndication
	821	+ module elements) or else from a randomly-generated time window
	822	+ (between 30 minutes and 2 hours).
	823	+
	824	+ - New posts from the polled feed are added to the WordPress store.
	825	+
	826	+ - Updates to existing posts since the last poll are mirrored in the
	827	+ WordPress store.
	828	+
	829	+ @param string|null $uri Either the URI of the feed to poll, the URI of the (human-readable) website whose feed you want to poll, or null.
	830	+ @param mixed|null $crash_ts Unknown purpose.
	831	+ @return array|null Associative array, with 'new' => # of new posts added during update, and 'updated' => # of old posts that were updated. If both are zero, there was no change since çast update.
	832	+ */
	833	+ public function update( $uri = null, $crash_ts = null ) {
	834	+ if ( FeedWordPress::needs_upgrade() ) : // Will make duplicate posts if we don't hold off
	835	+ return null;
947	836	endif;
948		-
949		- if (!is_null($uri)) :
950		- $uri = trim($uri);
	837	+
	838	+ if ( ! is_null( $uri ) and $uri != '*' ) :
	839	+ $uri = trim( $uri );
951	840	else : // Update all
952		- update_option('feedwordpress_last_update_all', time());
	841	+ if ( $this->update_hooked ) :
	842	+ $diag = $this->update_hooked;
	843	+ else :
	844	+ $diag = 'Initiating a MANUAL check-in on the update schedule at ' . date( 'r', time() );
	845	+ endif;
	846	+ $this->diagnostic( 'update_schedule:check', $diag );
	847	+
	848	+ update_option( 'feedwordpress_last_update_all', time() );
953	849	endif;
954	850
955		- do_action('feedwordpress_update', $uri);
	851	+ do_action( 'feedwordpress_update', $uri );
956	852
957		- if (is_null($crash_ts)) :
958		- $crash_dt = (int) get_option('feedwordpress_update_time_limit');
959		- if ($crash_dt > 0) :
960		- $crash_ts = time() + $crash_dt;
961		- else :
962		- $crash_ts = NULL;
963		- endif;
	853	+ if ( is_null( $crash_ts ) ) :
	854	+ $crash_ts = $this->crash_ts();
964	855	endif;
965		-
	856	+
966	857	// Randomize order for load balancing purposes
967		- $feed_set = $this->feeds;
968		- shuffle($feed_set);
	858	+ $feed_set = array_keys( $this->feeds );
	859	+ shuffle( $feed_set );
969	860
	861	+ $updateWindow = (int) get_option( 'feedwordpress_update_window', DEFAULT_UPDATE_PERIOD ) * 60 /* sec/min */;
	862	+ $interval = (int) get_option( 'feedwordpress_freshness', FEEDWORDPRESS_FRESHNESS_INTERVAL );
	863	+ $portion = max(
	864	+ (int) ceil( count( $feed_set ) / ( $updateWindow / $interval ) ),
	865	+ 10
	866	+ );
	867	+
	868	+ $max_polls = apply_filters(
	869	+ 'feedwordpress_polls_per_update',
	870	+ get_option(
	871	+ 'feedwordpress_polls_per_update', $portion
	872	+ ),
	873	+ $uri
	874	+ );
	875	+
	876	+ $feed_set = apply_filters( 'feedwordpress_update_feeds', $feed_set, $uri );
	877	+
970	878	// Loop through and check for new posts
971		- $delta = NULL;
972		- foreach ($feed_set as $feed) :
973		- if (!is_null($crash_ts) and (time() > $crash_ts)) : // Check whether we've exceeded the time limit
	879	+ $delta = null;
	880	+ $remaining = $max_polls;
	881	+ foreach ( $feed_set as $feed_id) :
	882	+
	883	+ $feed = $this->subscription( $feed_id );
	884	+ // Try to catch a very unusual condition where the $feed comes as NULL (gwyneth 20230919)
	885	+ if ( ! empty( $feed ) ) :
	886	+ $this->diagnostic( 'update_schedule', "Feed " . $feed_id . " returned an empty feed" );
	887	+ endif;
	888	+
	889	+ // Has this process overstayed its welcome?
	890	+ if (
	891	+ // Over time limit?
	892	+ ( ! is_null( $crash_ts ) and ( time() > $crash_ts ) )
	893	+
	894	+ // Over feed count?
	895	+ or ( 0 == $remaining )
	896	+ ) :
974	897	break;
975	898	endif;
976	899
977		- $pinged_that = (is_null($uri) or ($uri=='*') or in_array($uri, array($feed->uri(), $feed->homepage())));
	900	+ $pinged_that = ( is_null( $uri ) or ( $uri == '*' ) or in_array( $uri, array( $feed->uri(), $feed->homepage() ) ) );
978	901
979		- if (!is_null($uri)) : // A site-specific ping always updates
	902	+ if ( ! is_null( $uri ) ) : // A site-specific ping always updates
980	903	$timely = true;
981	904	else :
982	905	$timely = $feed->stale();
983	906	endif;
984	907
985		- if ($pinged_that and is_null($delta)) : // If at least one feed was hit for updating...
986		- $delta = array('new' => 0, 'updated' => 0); // ... don't return error condition
	908	+ // If at least one feed was hit for updating...
	909	+ if ( $pinged_that and is_null( $delta ) ) :
	910	+ // ... don't return error condition
	911	+ $delta = array( 'new' => 0, 'updated' => 0, 'stored' => 0 );
987	912	endif;
988	913
989		- if ($pinged_that and $timely) :
990		- do_action('feedwordpress_check_feed', $feed->settings);
	914	+ if ( $pinged_that and $timely ) :
	915	+ $remaining = $remaining - 1;
	916	+
	917	+ do_action( 'feedwordpress_check_feed', $feed->settings );
991	918	$start_ts = time();
992		- $added = $feed->poll($crash_ts);
993		- do_action('feedwordpress_check_feed_complete', $feed->settings, $added, time() - $start_ts);
	919	+ $added = $feed->poll( $crash_ts );
	920	+ do_action( 'feedwordpress_check_feed_complete', $feed->settings, $added, time() - $start_ts );
994	921
995		- if (isset($added['new'])) : $delta['new'] += $added['new']; endif;
996		- if (isset($added['updated'])) : $delta['updated'] += $added['updated']; endif;
	922	+ if ( is_array( $added ) ) : // Success
	923	+ foreach ( $added as $key => $count ) :
	924	+ $delta[ $key ] += $added[ $key ];
	925	+ endforeach;
	926	+ endif;
997	927	endif;
998	928	endforeach;
999	929
1000		- do_action('feedwordpress_update_complete', $delta);
	930	+ do_action( 'feedwordpress_update_complete', $delta );
	931	+ return $delta;
	932	+ } /* FeedWordPress::update () */
1001	933
1002		- return $delta;
1003		- }
	934	+ /**
	935	+ * Checks if we're over the update time limit.
	936	+ *
	937	+ * @todo is returning null advisable? (gwyneth 20230916)
	938	+ *
	939	+ * @param int|null $default Default value, called when the corresponding FWP option is not set.
	940	+ *
	941	+ * @return int|null
	942	+ */
	943	+ public function crash_ts( $default = null ) {
	944	+ $crash_dt = (int) get_option( 'feedwordpress_update_time_limit', 0 );
	945	+ if ( $crash_dt > 0 ) :
	946	+ $crash_ts = time() + $crash_dt;
	947	+ else :
	948	+ $crash_ts = $default;
	949	+ endif;
	950	+ return $crash_ts;
	951	+ } /* FeedWordPress::crash_ts () */
1004	952
1005		- function stale () {
1006		- if (get_option('feedwordpress_automatic_updates')) :
	953	+
	954	+ /**
	955	+ * Checks if we have a secret key set in the options; if not, generate one.
	956	+ *
	957	+ * @return string Secret key, either from options or auto-generated.
	958	+ *
	959	+ * @todo Only 6 characters? That is rather easy to guess... Also, uniqid() can return 13 or 23
	960	+ * characters, what's the point of using MD5 in this case? (gwyneth 20230916)
	961	+ */
	962	+ public function secret_key() {
	963	+ $secret = get_option( 'feedwordpress_secret_key', false );
	964	+ if ( ! $secret) : // Generate random key.
	965	+ $secret = substr( md5( uniqid( microtime() ) ), 0, 6 );
	966	+ update_option( 'feedwordpress_secret_key', $secret );
	967	+ endif;
	968	+ return $secret;
	969	+ } /* FeedWordPress::secret_key () */
	970	+
	971	+ /**
	972	+ * Returns true if we have set a secret FWP key.
	973	+ *
	974	+ * @return bool True if we have a secret key, false otherwise
	975	+ *
	976	+ * @uses MyPHP::request()
	977	+ */
	978	+ public function has_secret() {
	979	+ return ( MyPHP::request( 'feedwordpress_key' ) == $this->secret_key() );
	980	+ } /* FeedWordPress::has_secret () */
	981	+
	982	+ var $update_hooked = null;
	983	+
	984	+ /**
	985	+ * Activates the hook for automatic plugin updates, if requested.
	986	+ *
	987	+ * @param Array $params Parameters to send to the hook.
	988	+ *
	989	+ * @return string Represents the hook's name. There is a slight chance that this is null, though. (gwyneth 20230916)
	990	+ *
	991	+ * @uses wp_parse_args()
	992	+ * @uses MyPHP::request()
	993	+ */
	994	+ public function automatic_update_hook( $params = array() ) {
	995	+ $params = wp_parse_args( $params, array( // Defaults
	996	+ 'setting only' => false,
	997	+ ));
	998	+ $hook = get_option( 'feedwordpress_automatic_updates', null );
	999	+ $method = 'FeedWordPress option';
	1000	+
	1001	+ // Allow for forced behavior in testing.
	1002	+ if (
	1003	+ ! $params['setting only']
	1004	+ and $this->has_secret()
	1005	+ and MyPHP::request( 'automatic_update' )
	1006	+ ) :
	1007	+ $hook = MyPHP::request( 'automatic_update') ;
	1008	+ $method = 'URL parameter';
	1009	+ endif;
	1010	+
	1011	+ $exact = $hook; // Before munging
	1012	+
	1013	+ if ( !! $hook) :
	1014	+ if ( $hook == 'init' or $hook == 'wp_loaded' ) : // Re-map init to wp_loaded
	1015	+ $hook = ( $params['setting only'] ? 'init' : 'wp_loaded' );
	1016	+
	1017	+ // Constrain possible values. If it's not an init or wp_loaded, it's a shutdown
	1018	+ else :
	1019	+ $hook = 'shutdown';
	1020	+ endif;
	1021	+ endif;
	1022	+
	1023	+ if ( $hook ) :
	1024	+ $this->update_hooked = "Initiating an AUTOMATIC CHECK FOR UPDATES ON PAGE LOAD " . $hook . " due to " . $method . " = " . trim( $this->val( $exact ) );
	1025	+ endif;
	1026	+
	1027	+ return $hook;
	1028	+ } /* FeedWordPress::automatic_update_hook () */
	1029	+
	1030	+ public function last_update_all () {
	1031	+ $last = get_option('feedwordpress_last_update_all');
	1032	+ if ( $this->has_secret() and FeedWordPress::param('automatic_update') ) :
	1033	+ $last = 1; // A long, long time ago.
	1034	+ elseif ( $this->has_secret() and FeedWordPress::param('last_update_all') ) :
	1035	+ $last = FeedWordPress::param( 'last_update_all' );
	1036	+ endif;
	1037	+ return $last;
	1038	+ } /* FeedWordPress::last_update_all () */
	1039	+
	1040	+ public function force_update_all () {
	1041	+ return ($this->has_secret() and FeedWordPress::param( 'force_update_feeds' ));
	1042	+ } /* FeedWordPress::force_update_all () */
	1043	+
	1044	+ public function stale () {
	1045	+ if ( !is_null($this->automatic_update_hook())) :
1007	1046	// Do our best to avoid possible simultaneous
1008	1047	// updates by getting up-to-the-minute settings.
1009		-
1010		- $last = get_option('feedwordpress_last_update_all');
1011		-
	1048	+
	1049	+ $last = $this->last_update_all();
	1050	+
1012	1051	// If we haven't updated all yet, give it a time window
1013	1052	if (false === $last) :
1014	1053	$ret = false;
1015	1054	update_option('feedwordpress_last_update_all', time());
1016		-
	1055	+
1017	1056	// Otherwise, check against freshness interval
1018	1057	elseif (is_numeric($last)) : // Expect a timestamp
1019	1058	$freshness = get_option('feedwordpress_freshness');
1020	1059	if (false === $freshness) : // Use default
		@@ -1019,13 +1058,13 @@
1019	1058	$freshness = get_option('feedwordpress_freshness');
1020	1059	if (false === $freshness) : // Use default
1021	1060	$freshness = FEEDWORDPRESS_FRESHNESS_INTERVAL;
1022	1061	endif;
1023		- $ret = ( (time() - $last) > $freshness);
	1062	+ $ret = ( (time() - $last) > $freshness );
1024	1063
1025		- // This should never happen.
	1064	+ // This should never happen.
1026	1065	else :
1027		- FeedWordPress::critical_bug('FeedWordPress::stale::last', $last, __LINE__);
	1066	+ FeedWordPressDiagnostic::critical_bug('FeedWordPress::stale::last', $last, __LINE__, __FILE__);
1028	1067	endif;
1029	1068
1030	1069	else :
1031	1070	$ret = false;
		@@ -1030,102 +1069,713 @@
1030	1069	else :
1031	1070	$ret = false;
1032	1071	endif;
1033	1072	return $ret;
1034		- } // FeedWordPress::stale()
1035		-
1036		- function update_requested () {
1037		- return (
1038		- isset($_REQUEST['update_feedwordpress'])
1039		- and $_REQUEST['update_feedwordpress']
1040		- );
1041		- } // FeedWordPress::update_requested()
	1073	+ } /* FeedWordPress::stale() */
1042	1074
1043		- function update_requested_url () {
1044		- $ret = null;
1045		-
1046		- if (($_REQUEST['update_feedwordpress']=='*')
1047		- or (preg_match('|^http://.*|i', $_REQUEST['update_feedwordpress']))) :
1048		- $ret = $_REQUEST['update_feedwordpress'];
	1075	+ static function admin_init () {
	1076	+ // WordPress 3.5+ compat: the WP devs are in the midst of removing Links from the WordPress core. Eventually we'll have to deal
	1077	+ // with the possible disappearance of the wp_links table as a whole; but in the meantime, we just need to turn on the interface
	1078	+ // element to avoid problems with user capabilities that presume the presence of the Links Manager in the admin UI.
	1079	+ global $post_type;
	1080	+
	1081	+ if ( !intval(get_option('link_manager_enabled', false))) :
	1082	+ update_option('link_manager_enabled', true);
	1083	+ endif;
	1084	+
	1085	+ if (defined('FEEDWORDPRESS_PREPARE_TO_ZAP') and FEEDWORDPRESS_PREPARE_TO_ZAP) :
	1086	+ $post_id = FEEDWORDPRESS_PREPARE_TO_ZAP;
	1087	+ $sendback = wp_get_referer();
	1088	+ if (
	1089	+ ! $sendback
	1090	+ or strpos( $sendback, 'post.php' ) !== false
	1091	+ or strpos( $sendback, 'post-new.php' ) !== false
	1092	+ ) :
	1093	+ if ( 'attachment' == $post_type ) : // where does this come from?? I put it as a global...(gwyneth 20230916)
	1094	+ $sendback = admin_url( 'upload.php' );
	1095	+ else :
	1096	+ $sendback = admin_url( 'edit.php' );
	1097	+ $sendback .= ( ! empty( $post_type ) ) ? '?post_type=' . $post_type : '';
	1098	+ endif;
	1099	+ else :
	1100	+ $sendback = esc_url( remove_query_arg( array('trashed', 'untrashed', 'deleted', 'zapped', 'unzapped', 'ids'), $sendback ) );
1049	1101	endif;
1050	1102
1051		- return $ret;
1052		- } // FeedWordPress::update_requested_url()
	1103	+ // Make sure we have a post corresponding to this ID.
	1104	+ $post = $post_type = $post_type_object = null; // whatever $post_type_object might be, it's not being used! (gwyneth 20230920)
	1105	+ if ( $post_id ) :
	1106	+ $post = get_post( $post_id );
	1107	+ endif;
1053	1108
1054		- function syndicate_link ($name, $uri, $rss) {
1055		- global $wpdb;
	1109	+ if ( $post ) :
	1110	+ $post_type = $post->post_type;
	1111	+ endif;
	1112	+ $p = get_post( $post_id );
1056	1113
1057		- // Get the category ID#
1058		- $cat_id = FeedWordPress::link_category_id();
1059		-
1060		- // WordPress gets cranky if there's no homepage URI
1061		- if (!isset($uri) or strlen($uri)<1) : $uri = $rss; endif;
1062		-
1063		- if (function_exists('wp_insert_link')) : // WordPress 2.x
1064		- if (FeedWordPressCompatibility::test_version(0, FWP_SCHEMA_21)) :
1065		- // Morons.
1066		- $name = $wpdb->escape($name);
1067		- $uri = $wpdb->escape($uri);
1068		- $rss = $wpdb->escape($rss);
1069		-
1070		- // Comes in as a single category
1071		- $linkCats = $cat_id;
	1114	+ if ( ! $post ) :
	1115	+ wp_die( esc_html__( 'The item you are trying to zap no longer exists.' ) );
	1116	+ endif;
	1117	+
	1118	+ if ( ! current_user_can( 'delete_post', $post_id ) ) :
	1119	+ wp_die( esc_html__( 'You are not allowed to zap this item.' ) );
	1120	+ endif;
	1121	+
	1122	+ if ( $user_id = wp_check_post_lock( $post_id ) ) :
	1123	+ if ( is_numeric( $user_id ) and function_exists( 'get_userdata' ) ) :
	1124	+ $user = get_userdata( (int) $user_id );
	1125	+ wp_die( esc_html( sprintf( __( 'You cannot retire this item. %s is currently editing.' ), $user->display_name ) ) );
	1126	+ else :
	1127	+ wp_die( esc_html__( 'You cannot retire this item. Someone is currently editing.' ) );
	1128	+ endif;
	1129	+ endif;
	1130	+
	1131	+ if (FeedWordPress::param( 'fwp_post_delete' ) == 'zap') :
	1132	+ FeedWordPress::diagnostic('syndicated_posts', 'Zapping existing post # '.$p->ID.' "'.$p->post_title.'" due to user request.');
	1133	+
	1134	+ $old_status = $post->post_status;
	1135	+
	1136	+ set_post_field('post_status', 'fwpzapped', $post_id);
	1137	+ wp_transition_post_status('fwpzapped', $old_status, $post);
	1138	+
	1139	+ # Set up the post to have its content blanked on
	1140	+ # next update if you do not undo the zapping.
	1141	+ add_post_meta($post_id, '_feedwordpress_zapped_blank_me', 1, /*unique=*/ true);
	1142	+ add_post_meta($post_id, '_feedwordpress_zapped_blank_old_status', $old_status, /*unique=*/ true);
	1143	+
	1144	+ wp_redirect( esc_url_raw( add_query_arg( array('zapped' => 1, 'ids' => $post_id), $sendback ) ) );
	1145	+
1072	1146	else :
1073		- // Comes in as an array of categories
1074		- $linkCats = array($cat_id);
	1147	+ $old_status = get_post_meta($post_id, '_feedwordpress_zapped_blank_old_status', /*single=*/ true);
	1148	+
	1149	+ set_post_field('post_status', $old_status, $post_id);
	1150	+ wp_transition_post_status($old_status, 'fwpzapped', $post);
	1151	+
	1152	+ # O.K., make sure this post does not get blanked
	1153	+ delete_post_meta($post_id, '_feedwordpress_zapped_blank_me');
	1154	+ delete_post_meta($post_id, '_feedwordpress_zapped_blank_old_status');
	1155	+
	1156	+ wp_redirect( esc_url_raw( add_query_arg( array('unzapped' => 1, 'ids' => $post_id), $sendback ) ) );
	1157	+
1075	1158	endif;
1076	1159
1077		- $link_id = wp_insert_link(array(
1078		- "link_name" => $name,
1079		- "link_url" => $uri,
1080		- "link_category" => $linkCats,
1081		- "link_rss" => $rss
	1160	+ // Intercept, don't pass on.
	1161	+ exit;
	1162	+ endif;
	1163	+ } /* FeedWordPress::admin_init() */
	1164	+
	1165	+ public function admin_api () {
	1166	+ // This sucks, but WordPress doesn't give us any other way to
	1167	+ // easily invoke a permanent-delete from a plugged in post
	1168	+ // actions link. So we create a magic parameter, and when this
	1169	+ // magic parameter is activated, the WordPress trashcan is
	1170	+ // temporarily de-activated.
	1171	+
	1172	+ if (FeedWordPress::param( 'fwp_post_delete' ) == 'nuke') :
	1173	+ // Get post ID #
	1174	+ $post_id = FeedWordPress::param( 'post' );
	1175	+ if ( ! $post_id) :
	1176	+ $post_id = FeedWordPress::param( 'post_ID' );
	1177	+ endif;
	1178	+
	1179	+ // Make sure we've got the right nonce and all that.
	1180	+ check_admin_referer('delete-post_' . $post_id);
	1181	+
	1182	+ // If so, disable the trashcan.
	1183	+ define('EMPTY_TRASH_DAYS', 0);
	1184	+ elseif ( FeedWordPress::param( 'fwp_post_delete' ) == 'zap' || FeedWordPress::param( 'fwp_post_delete' ) == 'unzap' ) :
	1185	+ // Get post ID #
	1186	+ $post_id = FeedWordPress::param( 'post' );
	1187	+ if ( ! $post_id) :
	1188	+ $post_id = FeedWordPress::param( 'post_ID' );
	1189	+ endif;
	1190	+
	1191	+ // Make sure we've got the right nonce and all that
	1192	+ check_admin_referer('delete-post_' . $post_id);
	1193	+
	1194	+ // If so, get ready to intercept the call a little
	1195	+ // further down the line.
	1196	+ define('FEEDWORDPRESS_PREPARE_TO_ZAP', $post_id);
	1197	+
	1198	+ endif;
	1199	+
	1200	+ } /* FeedWordPress::admin_api () */
	1201	+
	1202	+ public function all_admin_notices () {
	1203	+ if (FeedWordPress::param( 'zapped' )) :
	1204	+ $n = intval( FeedWordPress::param( 'zapped' ) );
	1205	+?>
	1206	+<div id="message" class="updated"><p><?php print esc_html( $n ); ?> syndicated item<?php print esc_html( $n != 1 ? 's' : '' ); ?> zapped. <strong>These items will not be re-syndicated.</strong> If this was a mistake, you must <strong>immediately</strong> Un-Zap them in the Zapped items section to avoid losing the data.</p></div>
	1207	+<?php
	1208	+ endif;
	1209	+ if ( FeedWordPress::param( 'unzapped' ) ) :
	1210	+ $n = intval( FeedWordPress::param( 'unzapped' ) );
	1211	+?>
	1212	+<div id="message" class="updated"><p><?php print esc_html( $n ); ?> syndicated item<?php print esc_html( $n != 1 ? 's' : '' ) ?> un-zapped and restored to normal.</p></div>
	1213	+<?php
	1214	+ endif;
	1215	+ } /* FeedWordPress::all_admin_notices () */
	1216	+
	1217	+ public function process_retirements ($delta) {
	1218	+ update_option('feedwordpress_process_zaps', 1);
	1219	+
	1220	+ return $delta;
	1221	+ }
	1222	+
	1223	+ public function feedwordpress_cleanup () {
	1224	+ if (get_option('feedwordpress_process_zaps', null)) :
	1225	+ $q = new WP_Query(array(
	1226	+ 'fields' => '_synfrom',
	1227	+ 'post_status' => 'fwpzapped',
	1228	+ 'ignore_sticky_posts' => true,
	1229	+ 'meta_key' => '_feedwordpress_zapped_blank_me',
	1230	+ 'meta_value' => 1,
1082	1231	));
1083		- else : // WordPress 1.5.x
1084		- $result = $wpdb->query("
1085		- INSERT INTO $wpdb->links
1086		- SET
1087		- link_name = '".$wpdb->escape($name)."',
1088		- link_url = '".$wpdb->escape($uri)."',
1089		- link_category = '".$wpdb->escape($cat_id)."',
1090		- link_rss = '".$wpdb->escape($rss)."'
1091		- ");
1092		- $link_id = $wpdb->insert_id;
	1232	+
	1233	+ if ($q->have_posts()) :
	1234	+ foreach ($q->posts as $p) :
	1235	+
	1236	+ $post_id = $p->ID;
	1237	+ $revisions = wp_get_post_revisions($post_id, array("check_enabled" => false));
	1238	+
	1239	+ # Now nuke the content of the post & its revisions
	1240	+ set_post_field('post_content', '', $post_id);
	1241	+ set_post_field('post_excerpt', '', $post_id);
	1242	+
	1243	+ foreach ($revisions as $rev) :
	1244	+ set_post_field('post_content', '', $rev->ID);
	1245	+ set_post_field('post_excerpt', '', $rev->ID);
	1246	+ endforeach;
	1247	+
	1248	+ # Un-tag it for blanking.
	1249	+ delete_post_meta($p->ID, '_feedwordpress_zapped_blank_me');
	1250	+
	1251	+ # Don't remove old_status indicator. A later
	1252	+ # update from the feed may cause us to once
	1253	+ # again have some content so we can un-zap.
	1254	+
	1255	+ endforeach;
	1256	+ endif;
	1257	+
	1258	+ $q = new WP_Query(array(
	1259	+ 'fields' => '_synfrom',
	1260	+ 'post_status' => 'fwpzapped',
	1261	+ 'ignore_sticky_posts' => true,
	1262	+ 'meta_key' => '_feedwordpress_zapped_blank_me',
	1263	+ 'meta_value' => 2,
	1264	+ ));
	1265	+
	1266	+ if ($q->have_posts()) :
	1267	+ foreach ($q->posts as $p) :
	1268	+ update_post_meta($p->ID, '_feedwordpress_zapped_blank_me', 1);
	1269	+ endforeach;
	1270	+ endif;
	1271	+
	1272	+ update_option('feedwordpress_process_zaps', 0);
1093	1273	endif;
1094		- return $link_id;
1095		- } // function FeedWordPress::syndicate_link()
	1274	+ } /* FeedWordPress::feedwordpress_cleanup () */
1096	1275
1097		- /*static*/ function syndicated_status ($what, $default) {
1098		- $ret = get_option("feedwordpress_syndicated_{$what}_status");
1099		- if (!$ret) :
1100		- $ret = $default;
	1276	+ public function init () {
	1277	+
	1278	+ // If this is a FeedWordPress admin page, queue up scripts for AJAX
	1279	+ // functions that FWP uses. If it is a display page or a non-FWP admin
	1280	+ // page, don't.
	1281	+ wp_register_style('feedwordpress-elements', $this->plugin_dir_url( 'assets/css/feedwordpress-elements.css') );
	1282	+ if (FeedWordPressSettingsUI::is_admin()) :
	1283	+ // For JavaScript that needs to be generated dynamically
	1284	+ add_action('admin_print_scripts', array('FeedWordPressSettingsUI', 'admin_scripts'));
	1285	+
	1286	+ // For CSS that needs to be generated dynamically.
	1287	+ add_action('admin_print_styles', array('FeedWordPressSettingsUI', 'admin_styles'));
	1288	+
	1289	+ wp_enqueue_style('dashboard');
	1290	+ wp_enqueue_style('feedwordpress-elements');
1101	1291	endif;
1102		- return $ret;
1103		- } /* FeedWordPress::syndicated_status() */
1104	1292
1105		- function on_unfamiliar ($what = 'author', $override = NULL) {
1106		- $set = array(
1107		- 'author' => array('create', 'default', 'filter'),
1108		- 'category' => array('create', 'tag', 'default', 'filter'),
	1293	+ // These are a special post statuses for hiding posts that have
	1294	+ // expired from the feed or been marked for permanent zapping by
	1295	+ // the FWP admin.
	1296	+ register_post_status('fwpretired', array(
	1297	+ 'label' => _x('Retired', 'post'),
	1298	+ 'label_count' => _n_noop('Retired <span class="count">(%s)</span>', 'Retired <span class="count">(%s)</span>'),
	1299	+ 'exclude_from_search' => true,
	1300	+ 'public' => false,
	1301	+ 'publicly_queryable' => false,
	1302	+ 'show_in_admin_all_list' => false,
	1303	+ 'show_in_admin_status_list' => true,
	1304	+ ));
	1305	+ register_post_status('fwpzapped', array(
	1306	+ 'label' => _x('Zapped', 'post'),
	1307	+ 'label_count' => _n_noop('Zapped <span class="count">(%s)</span>', 'Retired <span class="count">(%s)</span>'),
	1308	+ 'exclude_from_search' => true,
	1309	+ 'public' => false,
	1310	+ 'publicly_queryable' => false,
	1311	+ 'show_in_admin_all_list' => false,
	1312	+ 'show_in_admin_status_list' => true,
	1313	+ ));
	1314	+ add_action(
	1315	+ /*hook=*/ 'template_redirect',
	1316	+ /*function=*/ array($this, 'redirect_retired'),
	1317	+ /*priority=*/ -100
1109	1318	);
1110		-
1111		- if (is_string($override)) :
1112		- $ret = strtolower($override);
	1319	+
	1320	+ add_action('wp_ajax_fwp_feeds', array($this, 'fwp_feeds'));
	1321	+ add_action('wp_ajax_fwp_feedcontents', array($this, 'fwp_feedcontents'));
	1322	+ add_action('wp_ajax_fwp_xpathtest', array($this, 'fwp_xpathtest'));
	1323	+
	1324	+ // Prepare for future translations... (gwyneth 20210714)
	1325	+ // add_action('init', array($this, 'load_textdomain');
	1326	+ } /* FeedWordPress::init() */
	1327	+
	1328	+ /**
	1329	+ * FeedWordPress::wp_loaded (): Once all plugin and theme modules have been
	1330	+ * loaded and initialized (by actions on the init hook, etc.), check the HTTP
	1331	+ * request to see if we need to perform any special FeedWordPress-related
	1332	+ * actions.
	1333	+ *
	1334	+ * @since 2016.0614
	1335	+ */
	1336	+ public function wp_loaded () {
	1337	+ $this->clear_cache_magic_url();
	1338	+ $this->update_magic_url();
	1339	+ } /* FeedWordPress::wp_loaded () */
	1340	+
	1341	+ /**
	1342	+ * FeedWordPress::cron_schedules(): Filter hook to add WP-Cron schedules
	1343	+ * that plugins like FeedWordPress can use to carry out scheduled events.
	1344	+ *
	1345	+ * @param array $schedules An associative array containing the current set of cron schedules (hourly, daily, etc.)
	1346	+ * @return array The same array, with a new entry ('fwp_checkin_interval') added to the list.
	1347	+ *
	1348	+ * @since 2017.1021
	1349	+ */
	1350	+ public function cron_schedules ($schedules) {
	1351	+ $interval = FEEDWORDPRESS_DEFAULT_CHECKIN_INTERVAL*60 /*sec/min*/;
	1352	+
	1353	+ // add 'fwp_checkin_interval' to the existing set
	1354	+ $schedules['fwp_checkin_interval'] = array(
	1355	+ 'interval' => $interval,
	1356	+ 'display' => 'FeedWordPress update schedule check-in',
	1357	+ );
	1358	+
	1359	+ return $schedules;
	1360	+ } /* FeedWordPress::cron_schedules () */
	1361	+
	1362	+ public function fwp_feeds () {
	1363	+ $feeds = array();
	1364	+ $feed_ids = $this->feeds;
	1365	+
	1366	+ foreach ($feed_ids as $id) :
	1367	+ $sub = $this->subscription($id);
	1368	+ $feeds[] = array(
	1369	+ "id" => $id,
	1370	+ "url" => $sub->uri(),
	1371	+ "name" => $sub->name(/*fromFeed=*/ false),
	1372	+ );
	1373	+ endforeach;
	1374	+
	1375	+ header("Content-Type: application/json");
	1376	+ echo json_encode($feeds);
	1377	+ exit;
	1378	+ } /* FeedWordPress::fwp_feeds () */
	1379	+
	1380	+ public function fwp_feedcontents () {
	1381	+ $feed_id = FeedWordPress::param( 'feed_id' );
	1382	+
	1383	+ // Let's load up some data from the feed . . .
	1384	+ $feed = $this->subscription($feed_id);
	1385	+ $posts = $feed->live_posts();
	1386	+
	1387	+ if (is_wp_error($posts)) :
	1388	+ header("HTTP/1.1 502 Bad Gateway");
	1389	+ $result = $posts;
1113	1390	else :
1114		- $ret = NULL;
	1391	+ $result = array();
	1392	+
	1393	+ foreach ($posts as $post) :
	1394	+ $p = new SyndicatedPost($post, $feed);
	1395	+
	1396	+ $result[] = array(
	1397	+ "post_title" => $p->entry->get_title(),
	1398	+ "post_link" => $p->permalink(),
	1399	+ "guid" => $p->guid(),
	1400	+ "post_date" => $p->published(),
	1401	+ );
	1402	+ endforeach;
1115	1403	endif;
1116	1404
1117		- if (!is_numeric($override) and !in_array($ret, $set[$what])) :
1118		- $ret = get_option('feedwordpress_unfamiliar_'.$what);
1119		- if (!is_numeric($ret) and !in_array($ret, $set[$what])) :
1120		- $ret = 'create';
	1405	+ header("Content-Type: application/json");
	1406	+
	1407	+ echo json_encode($result);
	1408	+
	1409	+ // This is an AJAX request, so close it out thus.
	1410	+ die;
	1411	+ } /* FeedWordPress::fwp_feedcontents () */
	1412	+
	1413	+ public function fwp_xpathtest () {
	1414	+ $xpath = FeedWordPress::param( 'xpath' );
	1415	+ $feed_id = FeedWordPress::param( 'feed_id' );
	1416	+ $post_id = FeedWordPress::param( 'post_id' );
	1417	+
	1418	+ $expr = new FeedWordPressParsedPostMeta($xpath);
	1419	+
	1420	+ // Let's load up some data from the feed . . .
	1421	+ $feed = $this->subscription($feed_id);
	1422	+ $posts = $feed->live_posts();
	1423	+
	1424	+ if ( !is_wp_error($posts)) :
	1425	+ if (strlen($post_id) == 0) :
	1426	+ $post = $posts[0];
	1427	+ else :
	1428	+ $post = null;
	1429	+
	1430	+ foreach ($posts as $p) :
	1431	+ if ($p->get_id() == $post_id) :
	1432	+ $post = $p;
	1433	+ endif;
	1434	+ endforeach;
1121	1435	endif;
	1436	+
	1437	+ $post = new SyndicatedPost($post, $feed);
	1438	+ $meta = $expr->do_substitutions($post);
	1439	+
	1440	+ $result = array(
	1441	+ "post_title" => $post->entry->get_title(),
	1442	+ "post_link" => $post->permalink(),
	1443	+ "guid" => $post->guid(),
	1444	+ "expression" => $xpath,
	1445	+ "results" => $meta
	1446	+ );
	1447	+ else :
	1448	+ $result = array(
	1449	+ "expression" => $xpath,
	1450	+ "feed_id" => $feed_id,
	1451	+ "post_id" => $post_id,
	1452	+ "results" => $posts
	1453	+ );
	1454	+
	1455	+ header("HTTP/1.1 503 Bad Gateway");
1122	1456	endif;
1123	1457
	1458	+ header("Content-Type: application/json");
	1459	+
	1460	+ echo json_encode($result);
	1461	+
	1462	+ // This is an AJAX request, so close it out thus.
	1463	+ die;
	1464	+ } /* FeedWordPress::fwp_xpathtest () */
	1465	+
	1466	+ public function redirect_retired () {
	1467	+ global $wp_query;
	1468	+ if (is_singular()) :
	1469	+ if (
	1470	+ 'fwpretired'==$wp_query->post->post_status
	1471	+ or 'fwpzapped'==$wp_query->post->post_status
	1472	+ ) :
	1473	+ do_action('feedwordpress_redirect_retired', $wp_query->post);
	1474	+
	1475	+ if ( !($template = get_404_template())) :
	1476	+ $template = get_index_template();
	1477	+ endif;
	1478	+ if ($template = apply_filters('template_include', $template)) :
	1479	+ header("HTTP/1.1 410 Gone");
	1480	+ include($template);
	1481	+ endif;
	1482	+ exit;
	1483	+ endif;
	1484	+ endif;
	1485	+ } /* FeedWordPress::redirect_retired () */
	1486	+
	1487	+ public function row_actions ($actions, $post) {
	1488	+ if (is_syndicated($post->ID) && current_user_can('edit_post', $post->ID)) :
	1489	+ $link = get_delete_post_link($post->ID, '', true);
	1490	+ $eraseLink = MyPHP::url($link, array("fwp_post_delete" => "nuke"));
	1491	+
	1492	+ $caption = apply_filters('feedwordpress_ui_erase_link_caption', __('Erase the record of this post (will be re-syndicated if it still appears on the feed).'));
	1493	+ $linktext = apply_filters('feedwordpress_ui_erase_link_text', __('Erase/Resyndicate'));
	1494	+
	1495	+ $retireClass = null;
	1496	+ if ($post->post_status == 'fwpzapped') :
	1497	+ if (count(get_post_meta($post->ID, '_feedwordpress_zapped_blank_me')) > 0) :
	1498	+ $retireCap = 'Un-Zap this syndicated post (so it will appear on the site again)';
	1499	+ $retireText = 'Un-Zap &amp; Restore';
	1500	+ $retireLink = MyPHP::url($link, array("fwp_post_delete" => "unzap"));
	1501	+ else :
	1502	+ // No Un-Zap link for posts that have
	1503	+ // been blanked. You'll just have to
	1504	+ // Erase and hope you can resyndicate...
	1505	+ $retireLink = null;
	1506	+ endif;
	1507	+ else :
	1508	+ $retireCap = apply_filters('feedwordpress_ui_zap_link_caption', __('Zap this syndicated post (so it will not be re-syndicated if it still appears on the feed).'));
	1509	+ $retireText = apply_filters('feedwordpress_ui_zap_link_text', __('Zap/Don&rsquo;t Resyndicate'));
	1510	+ $retireLink = MyPHP::url($link, array("fwp_post_delete" => "zap"));
	1511	+ $retireClass = 'submitdelete';
	1512	+ endif;
	1513	+
	1514	+ $keys = array_keys($actions);
	1515	+ $links = array();
	1516	+ foreach ($keys as $key) :
	1517	+ $links[$key] = $actions[$key];
	1518	+
	1519	+ if ('trash'==$key) :
	1520	+ #$links[$key] = "<a class='submitdelete' title='" . esc_attr( __( 'Move this item to the Trash (will NOT be re-syndicated)' ) ) . "' href='" . get_delete_post_link( $post->ID ) . "'>" . __( 'Trash' ) . "</a>";
	1521	+
	1522	+ // Placeholder.
	1523	+ if ( !is_null($retireLink)) :
	1524	+ $links['zap trash'] = '';
	1525	+ endif;
	1526	+ $links['delete'] = '';
	1527	+ endif;
	1528	+ endforeach;
	1529	+
	1530	+ if ( !is_null($retireLink)) :
	1531	+ $links['zap trash'] = '<a class="'.esc_attr($retireClass).'" title="'.esc_attr(__($retireCap)).'" href="' . $retireLink . '">' . __($retireText) . '</a>';
	1532	+ endif;
	1533	+ $links['delete'] = '<a class="submitdelete" title="'.esc_attr(__($caption)).'" href="' . $eraseLink . '">' . __($linktext) . '</a>';
	1534	+
	1535	+ $actions = $links;
	1536	+ endif;
	1537	+ return $actions;
	1538	+ } /* FeedWordPress::row_actions () */
	1539	+
	1540	+ /**
	1541	+ * Sets up the FWP dashboard.
	1542	+ *
	1543	+ * @global $wp_meta_boxes
	1544	+ * @uses FeedWordPress::menu_cap
	1545	+ */
	1546	+ public function dashboard_setup() {
	1547	+ /** @var mixed User capability */
	1548	+ $see_it = FeedWordPress::menu_cap();
	1549	+
	1550	+ if ( current_user_can( $see_it ) ) :
	1551	+ // Get the stylesheet
	1552	+ wp_enqueue_style( 'feedwordpress-elements' );
	1553	+
	1554	+ $widget_id = 'feedwordpress_dashboard';
	1555	+ $widget_name = __( 'Syndicated Sources' );
	1556	+ $column = 'side';
	1557	+ $priority = 'core';
	1558	+
	1559	+ // I would love to use wp_add_dashboard_widget() here and save
	1560	+ // myself some trouble. But WP 3 does not yet have any way to
	1561	+ // push a dashboard widget onto the side, or to give it a default
	1562	+ // location.
	1563	+ add_meta_box(
	1564	+ /*id=*/ $widget_id,
	1565	+ /*title=*/ $widget_name,
	1566	+ /*callback=*/ array( $this, 'dashboard' ),
	1567	+ /*screen=*/ 'dashboard',
	1568	+ /*context=*/ $column,
	1569	+ /*priority=*/ $priority
	1570	+ );
	1571	+ /*control_callback= array($this, 'dashboard_control') */
	1572	+
	1573	+ /* This is kind of rude, I know, but the dashboard widget isn't
	1574	+ * worth much if users don't know that it exists, and I don't
	1575	+ * know of any better way to reorder the boxen.
	1576	+ *
	1577	+ * Gleefully ripped off of codex.wordpress.org/Dashboard_Widgets_API
	1578	+ */
	1579	+
	1580	+ /** @var mixed Globalizes the metaboxes array, this holds all the widgets for wp-admin. */
	1581	+ global $wp_meta_boxes;
	1582	+
	1583	+ /** @var mixed Get the regular dashboard widgets array
	1584	+ * (which has our new widget already but at the end). */
	1585	+ $normal_dashboard = $wp_meta_boxes['dashboard'][$column][$priority];
	1586	+
	1587	+ // Backup and delete our new dashbaord widget from the end of the array
	1588	+ if ( isset( $normal_dashboard[ $widget_id ] ) ) :
	1589	+ $backup = array();
	1590	+ $backup[ $widget_id ] = $normal_dashboard[ $widget_id ];
	1591	+ unset( $normal_dashboard[ $widget_id ] );
	1592	+
	1593	+ /** @var array Merge the two arrays together so our widget is at the beginning. */
	1594	+ $sorted_dashboard = array_merge( $backup, $normal_dashboard );
	1595	+
	1596	+ // Save the sorted array back into the original €es
	1597	+ $wp_meta_boxes['dashboard'][ $column ][ $priority ] = $sorted_dashboard;
	1598	+ endif;
	1599	+ endif;
	1600	+ } /* FeedWordPress::dashboard_setup () */
	1601	+
	1602	+ public function dashboard () {
	1603	+ $syndicationPage = new FeedWordPressSyndicationPage(dirname(__FILE__).'/syndication.php');
	1604	+ $syndicationPage->dashboard_box($syndicationPage);
	1605	+ } /* FeedWordPress::dashboard () */
	1606	+
	1607	+ public function user_can_richedit ($rich_edit) {
	1608	+
	1609	+ $post = new FeedWordPressLocalPost;
	1610	+
	1611	+ if ( ! $post->is_exposed_to_formatting_filters()) :
	1612	+ // Disable visual editor and only allow operations
	1613	+ // directly on HTML if post is bypassing fmt filters
	1614	+ # $rich_edit = false;
	1615	+ endif;
	1616	+
	1617	+ return $rich_edit;
	1618	+
	1619	+ } /* FeedWordPress::user_can_richedit () */
	1620	+
	1621	+ public function clear_cache_magic_url () {
	1622	+ if ($this->clear_cache_requested()) :
	1623	+ $this->clear_cache();
	1624	+ endif;
	1625	+ } /* FeedWordPress::clear_cache_magic_url() */
	1626	+
	1627	+ public function clear_cache_requested () {
	1628	+ return FeedWordPress::param( 'clear_cache' );
	1629	+ } /* FeedWordPress::clear_cache_requested() */
	1630	+
	1631	+ public function update_magic_url () {
	1632	+ global $wpdb;
	1633	+
	1634	+ // Explicit update request in the HTTP request (e.g. from a cron job)
	1635	+ if (self::update_requested()) :
	1636	+ /*DBG*/ header("Content-Type: text/plain");
	1637	+ $this->update_hooked = "Initiating a CRON JOB CHECK-IN ON UPDATE SCHEDULE due to URL parameter = " . trim( $this->val( FeedWordPress::param('update_feedwordpress' ) ) );
	1638	+
	1639	+ $this->update($this->update_requested_url());
	1640	+
	1641	+ if (FEEDWORDPRESS_DEBUG and is_array($wpdb->queries) and count($wpdb->queries) > 0) :
	1642	+ $mysqlTime = 0.0;
	1643	+ $byTime = array();
	1644	+ foreach ($wpdb->queries as $query) :
	1645	+ $time = $query[1] * 1000000.0;
	1646	+ $mysqlTime += $query[1];
	1647	+ if ( !isset($byTime[$time])) : $byTime[$time] = array(); endif;
	1648	+ $byTime[$time][] = $query[0]. ' // STACK: ' . $query[2];
	1649	+ endforeach;
	1650	+ krsort($byTime);
	1651	+
	1652	+ foreach ($byTime as $time => $querySet) :
	1653	+ foreach ($querySet as $query) :
	1654	+ printf( '[%s ms] %s', esc_html( sprintf( '%4.4f', $time/1000.0 ) ), esc_html( $query ) ) . "\n";
	1655	+ endforeach;
	1656	+ endforeach;
	1657	+ echo esc_html( self::log_prefix()."$wpdb->num_queries queries. $mysqlTime seconds in MySQL. Total of " ); timer_stop(1); print " seconds.";
	1658	+ endif;
	1659	+
	1660	+ debug_out_feedwordpress_footer();
	1661	+
	1662	+ // Magic URL should return nothing but a 200 OK header packet
	1663	+ // when successful.
	1664	+ exit;
	1665	+ endif;
	1666	+ } /* FeedWordPress::update_magic_url () */
	1667	+
	1668	+ public static function update_requested () {
	1669	+ return FeedWordPress::param( 'update_feedwordpress' );
	1670	+ } /* FeedWordPress::update_requested() */
	1671	+
	1672	+ public function update_requested_url () {
	1673	+ $ret = null;
	1674	+
	1675	+ $uf = FeedWordPress::update_requested();
	1676	+ if (
	1677	+ ( '*' == $uf )
	1678	+ || ( preg_match( '|^[a-z]+://.*|i', $uf ) )
	1679	+ ) :
	1680	+ $ret = $uf;
	1681	+ endif;
	1682	+
1124	1683	return $ret;
	1684	+ } /* FeedWordPress::update_requested_url() */
	1685	+
	1686	+ public function auto_update () {
	1687	+ if ($this->stale()) :
	1688	+ $this->update();
	1689	+ endif;
	1690	+ } /* FeedWordPress::auto_update () */
	1691	+
	1692	+ public static function find_link ($uri, $field = 'link_rss') {
	1693	+ global $wpdb;
	1694	+
	1695	+ $unslashed = untrailingslashit($uri);
	1696	+ $slashed = trailingslashit($uri);
	1697	+ $link_id = $wpdb->get_var($wpdb->prepare("
	1698	+ SELECT link_id FROM $wpdb->links WHERE $field IN ('%s', '%s')
	1699	+ LIMIT 1", $unslashed, $slashed
	1700	+ ));
	1701	+
	1702	+ return $link_id;
	1703	+ } /* FeedWordPress::find_link () */
	1704	+
	1705	+ /**
	1706	+ * FeedWordPress:syndicate_link(): add or update a feed subscription
	1707	+ *
	1708	+ * Add a new subscription to, or update an existing subscription in,
	1709	+ * FWP's list of subscribed feeds.
	1710	+ *
	1711	+ * Postcondition: If $rss is the URL of a feed not yet on FWP's list of
	1712	+ * subscribed feeds, then a new subscription will be added, using $name
	1713	+ * as its initial title and $uri as its initial homepage URL (normally
	1714	+ * these will be updated with new values taken from the feed, the first
	1715	+ * time the new feed is checked for syndicated content, unless feed
	1716	+ * settings prevent this). If $rss is the URL of a feed that is already
	1717	+ * on FWP's list of subscribed feeds, then that feed will be updated to
	1718	+ * use the title provided in $name and the homepage URL in $uri
	1719	+ *
	1720	+ * @param string $name The human-readable title of the feed (for example, "Rad Geek People's Daily")
	1721	+ * @param string $uri The URI for the human-readable homepage associated with the feed (for example, <http://radgeek.com/>)
	1722	+ * @param string $rss The URI for the feed itself (for example, <http://radgeek.com/feed/>)
	1723	+ *
	1724	+ * @return mixed Returns an int with the numeric ID of the new
	1725	+ * subscription's wp_links record if successful or a WP_Error object
	1726	+ * if wp_insert_link() failed.
	1727	+ *
	1728	+ * @uses FeedWordPress::link_category_id()
	1729	+ * @uses FeedWordPress::find_link()
	1730	+ * @uses is_wp_error()
	1731	+ * @uses wp_insert_link()
	1732	+ *
	1733	+ */
	1734	+ public static function syndicate_link ($name, $uri, $rss) {
	1735	+ // Get the category ID#
	1736	+ $cat_id = FeedWordPress::link_category_id();
	1737	+ if ( !is_wp_error($cat_id)) :
	1738	+ $link_category = array($cat_id);
	1739	+ else :
	1740	+ $link_category = array();
	1741	+ endif;
	1742	+
	1743	+ // WordPress gets cranky if there's no homepage URI
	1744	+ if ( !is_string($uri) or strlen($uri)<1) : $uri = $rss; endif;
	1745	+
	1746	+ // Check if this feed URL is already being syndicated.
	1747	+ $link_id = wp_insert_link(/*linkdata=*/ array(
	1748	+ "link_id" => FeedWordPress::find_link($rss), // insert if nothing was found; else update
	1749	+ "link_rss" => $rss,
	1750	+ "link_name" => $name,
	1751	+ "link_url" => $uri,
	1752	+ "link_category" => $link_category,
	1753	+ "link_visible" => 'Y', // reactivate if inactivated
	1754	+ ), /*wp_error=*/ true);
	1755	+
	1756	+ return $link_id;
	1757	+ } /* function FeedWordPress::syndicate_link() */
	1758	+
	1759	+ static function syndicated_status ($what, $default) {
	1760	+ $ret = get_option("feedwordpress_syndicated_{$what}_status");
	1761	+ if ( ! $ret) :
	1762	+ $ret = $default;
	1763	+ endif;
	1764	+ return $ret;
	1765	+ } /* FeedWordPress::syndicated_status() */
	1766	+
	1767	+ public static function on_unfamiliar ($what = 'author') {
	1768	+ switch ($what) :
	1769	+ case 'category' : $suffix = ':category'; break;
	1770	+ case 'post_tag' : $suffix = ':post_tag'; break;
	1771	+ default: $suffix = '';
	1772	+ endswitch;
	1773	+
	1774	+ return get_option('feedwordpress_unfamiliar_'.$what, 'create'.$suffix);
1125	1775	} // function FeedWordPress::on_unfamiliar()
1126	1776
1127		- function null_email_set () {
	1777	+ public static function null_email_set () {
1128	1778	$base = get_option('feedwordpress_null_email_set');
1129	1779
1130	1780	if ($base===false) :
1131	1781	$ret = array('noreply@blogger.com'); // default
		@@ -1137,36 +1787,49 @@
1137	1787	return $ret;
1138	1788
1139	1789	} /* FeedWordPress::null_email_set () */
1140	1790
1141		- function is_null_email ($email) {
1142		- $ret = in_array(strtolower(trim($email)), FeedWordPress::null_email_set());
1143		- $ret = apply_filters('syndicated_item_author_is_null_email', $ret, $email);
	1791	+ public static function is_null_email( $email ) {
	1792	+ $ret = in_array( strtolower( trim( $email ) ), FeedWordPress::null_email_set() );
	1793	+ $ret = apply_filters( 'syndicated_item_author_is_null_email', $ret, $email );
1144	1794	return $ret;
1145	1795	} /* FeedWordPress::is_null_email () */
1146	1796
1147		- function use_aggregator_source_data () {
	1797	+ public static function use_aggregator_source_data () {
1148	1798	$ret = get_option('feedwordpress_use_aggregator_source_data');
1149	1799	return apply_filters('syndicated_post_use_aggregator_source_data', ($ret=='yes'));
1150		- }
	1800	+ } /* FeedWordPress::use_aggregator_source_data () */
1151	1801
1152		- function syndicated_links () {
	1802	+ /**
	1803	+ * FeedWordPress::munge_permalinks: check whether or not FeedWordPress
	1804	+ * should rewrite permalinks for syndicated items to reflect their
	1805	+ * original location.
	1806	+ *
	1807	+ * @return bool TRUE if FeedWordPress SHOULD rewrite permalinks; FALSE otherwise
	1808	+ */
	1809	+ static function munge_permalinks () {
	1810	+ return (get_option('feedwordpress_munge_permalink', /*default=*/ 'yes') != 'no');
	1811	+ } /* FeedWordPress::munge_permalinks() */
	1812	+
	1813	+ public static function syndicated_links ($args = array()) {
1153	1814	$contributors = FeedWordPress::link_category_id();
1154		- if (function_exists('get_bookmarks')) :
1155		- $links = get_bookmarks(array("category" => $contributors));
1156		- else:
1157		- $links = get_linkobjects($contributors); // deprecated as of WP 2.1
	1815	+ if ( !is_wp_error($contributors)) :
	1816	+ $links = get_bookmarks(array_merge(
	1817	+ array("category" => $contributors),
	1818	+ $args
	1819	+ ));
	1820	+ else :
	1821	+ $links = array();
1158	1822	endif;
	1823	+
1159	1824	return $links;
1160		- } // function FeedWordPress::syndicated_links()
	1825	+ } /* FeedWordPress::syndicated_links() */
1161	1826
1162		- function link_category_id () {
1163		- global $wpdb, $wp_db_version;
	1827	+ public static function link_category_id () {
	1828	+ $cat_id = get_option('feedwordpress_cat_id');
1164	1829
1165		- $cat_id = get_option('feedwordpress_cat_id');
1166		-
1167	1830	// If we don't yet have the category ID stored, search by name
1168		- if (!$cat_id) :
	1831	+ if ( ! $cat_id) :
1169	1832	$cat_id = FeedWordPressCompatibility::link_category_id(DEFAULT_SYNDICATION_CATEGORY);
1170	1833
1171	1834	if ($cat_id) :
1172	1835	// We found it; let's stamp it.
		@@ -1176,115 +1839,95 @@
1176	1839	// If we *do* have the category ID stored, verify that it exists
1177	1840	else :
1178	1841	$cat_id = FeedWordPressCompatibility::link_category_id((int) $cat_id, 'cat_id');
1179	1842	endif;
1180		-
	1843	+
1181	1844	// If we could not find an appropriate link category,
1182	1845	// make a new one for ourselves.
1183		- if (!$cat_id) :
	1846	+ if ( ! $cat_id) :
1184	1847	$cat_id = FeedWordPressCompatibility::insert_link_category(DEFAULT_SYNDICATION_CATEGORY);
1185		-
1186		- // Stamp it
1187		- update_option('feedwordpress_cat_id', $cat_id);
	1848	+ if ( !is_wp_error($cat_id)) :
	1849	+ // Stamp it
	1850	+ update_option('feedwordpress_cat_id', $cat_id);
	1851	+ endif;
1188	1852	endif;
1189	1853
1190	1854	return $cat_id;
1191		- } // function FeedWordPress::link_category_id()
	1855	+ } /* FeedWordPress::link_category_id() */
1192	1856
1193	1857	# Upgrades and maintenance...
1194		- function needs_upgrade () {
1195		- global $wpdb;
1196		- $fwp_db_version = get_option('feedwordpress_version');
	1858	+ static function needs_upgrade () {
	1859	+ $fwp_db_version = get_option('feedwordpress_version', null);
1197	1860	$ret = false; // innocent until proven guilty
1198		- if (!$fwp_db_version or $fwp_db_version < FEEDWORDPRESS_VERSION) :
1199		- // This is an older version or a fresh install. Does it
1200		- // require a database upgrade or database initialization?
1201		- if ($fwp_db_version <= 0.96) :
1202		- // Yes. Check to see whether this is a fresh install or an upgrade.
1203		- $syn = $wpdb->get_col("
1204		- SELECT post_id
1205		- FROM $wpdb->postmeta
1206		- WHERE meta_key = 'syndication_feed'
1207		- ");
1208		- if (count($syn) > 0) : // contains at least one syndicated post
1209		- $ret = true;
1210		- else : // fresh install; brand it as ours
1211		- update_option('feedwordpress_version', FEEDWORDPRESS_VERSION);
	1861	+ if (is_null($fwp_db_version) or ($fwp_db_version < FEEDWORDPRESS_VERSION)) :
	1862	+
	1863	+ // This is an older version or a fresh install. Does it require a database
	1864	+ // upgrade or database initialization?
	1865	+
	1866	+ if (is_null($fwp_db_version)) :
	1867	+
	1868	+ // Fresh install; brand it as ours. Or possibly a version of FWP
	1869	+ // from before 0.96. But I'm no longer supporting upgrade paths
	1870	+ // for versions from the previous decade. Sorry.
	1871	+ update_option('feedwordpress_version', FEEDWORDPRESS_VERSION);
	1872	+
	1873	+ elseif ($fwp_db_version < 2010.0814) :
	1874	+
	1875	+ // Change in terminology.
	1876	+ if (get_option('feedwordpress_unfamiliar_category', 'create')=='default') :
	1877	+ update_option('feedwordpress_unfamiliar_category', 'null');
1212	1878	endif;
1213		- elseif ($fwp_db_version < 2009.0707) :
1214		- // We need to clear out any busted AJAX crap
1215		- if (fwp_test_wp_version(FWP_SCHEMA_HAS_USERMETA)) :
1216		- $wpdb->query("
1217		- DELETE FROM $wpdb->usermeta
1218		- WHERE LOCATE('feedwordpress', meta_key)
1219		- AND LOCATE('box', meta_key);
1220		- ");
1221		- endif;
	1879	+ foreach (FeedWordPress::syndicated_links() as $link) :
	1880	+ $sub = new SyndicatedLink($link);
	1881	+
	1882	+ $remap_uf = array(
	1883	+ 'default' => 'null',
	1884	+ 'filter' => 'null',
	1885	+ 'create' => 'create:category',
	1886	+ 'tag' => 'create:post_tag'
	1887	+ );
	1888	+ if (isset($sub->settings['unfamiliar category'])) :
	1889	+ if ($sub->settings['unfamiliar category']=='filter') :
	1890	+ $sub->settings['match/filter'] = array('category');
	1891	+ endif;
	1892	+ foreach ($remap_uf as $from => $to) :
	1893	+ if ($sub->settings['unfamiliar category']==$from) :
	1894	+ $sub->settings['unfamiliar category'] = $to;
	1895	+ endif;
	1896	+ endforeach;
	1897	+ endif;
	1898	+
	1899	+ if (isset($sub->settings['add global categories'])) :
	1900	+ $sub->settings['add/category'] = $sub->settings['add global categories'];
	1901	+ unset($sub->settings['add global categories']);
	1902	+ endif;
	1903	+
	1904	+ $sub->save_settings(/*reload=*/ true);
	1905	+ endforeach;
1222	1906	update_option('feedwordpress_version', FEEDWORDPRESS_VERSION);
	1907	+
1223	1908	else :
1224		- // No. Just brand it with the new version.
	1909	+
	1910	+ // No upgrade needed. Just brand it with the new version.
1225	1911	update_option('feedwordpress_version', FEEDWORDPRESS_VERSION);
	1912	+
1226	1913	endif;
	1914	+
1227	1915	endif;
1228	1916	return $ret;
1229		- }
	1917	+ } /* FeedWordPress::needs_upgrade () */
1230	1918
1231		- function upgrade_database ($from = NULL) {
1232		- global $wpdb;
1233		-
	1919	+ static function upgrade_database ($from = null)
	1920	+ {
1234	1921	if (is_null($from) or $from <= 0.96) : $from = 0.96; endif;
1235	1922
1236	1923	switch ($from) :
1237		- case 0.96: // account for changes to syndication custom values and guid
1238		- echo "<p>Upgrading database from {$from} to ".FEEDWORDPRESS_VERSION."...</p>\n";
	1924	+ case 0.96:
	1925	+ // Dropping legacy upgrade code. If anyone is still
	1926	+ // using 0.96 and just now decided to upgrade, well, I'm
	1927	+ // sorry about that. You'll just have to cope with a few
	1928	+ // duplicate posts.
1239	1929
1240		- $cat_id = FeedWordPress::link_category_id();
1241		-
1242		- // Avoid duplicates
1243		- $wpdb->query("DELETE FROM `{$wpdb->postmeta}` WHERE meta_key = 'syndication_feed_id'");
1244		-
1245		- // Look up all the link IDs
1246		- $wpdb->query("
1247		- CREATE TEMPORARY TABLE tmp_custom_values
1248		- SELECT
1249		- NULL AS meta_id,
1250		- post_id,
1251		- 'syndication_feed_id' AS meta_key,
1252		- link_id AS meta_value
1253		- FROM `{$wpdb->postmeta}`, `{$wpdb->links}`
1254		- WHERE
1255		- meta_key='syndication_feed'
1256		- AND meta_value=link_rss
1257		- AND link_category = {$cat_id}
1258		- ");
1259		-
1260		- // Now attach them to their posts
1261		- $wpdb->query("INSERT INTO `{$wpdb->postmeta}` SELECT * FROM tmp_custom_values");
1262		-
1263		- // And clean up after ourselves.
1264		- $wpdb->query("DROP TABLE tmp_custom_values");
1265		-
1266		- // Now fix the guids to avoid duplicate posts
1267		- echo "<ul>";
1268		- foreach ($this->feeds as $syndicatedLink) :
1269		- $feed = $syndicatedLink->settings;
1270		- echo "<li>Fixing post meta-data for <cite>".$feed['link/name']."</cite> &#8230; "; flush();
1271		- $rss = @fetch_rss($feed['link/uri']);
1272		- if (is_array($rss->items)) :
1273		- foreach ($rss->items as $item) :
1274		- $post = new SyndicatedPost($item, $syndicatedLink);
1275		- $guid = $wpdb->escape($post->guid()); // new GUID algorithm
1276		- $link = $wpdb->escape($item['link']);
1277		-
1278		- $wpdb->query("
1279		- UPDATE `{$wpdb->posts}` SET guid='{$guid}' WHERE guid='{$link}'
1280		- ");
1281		- endforeach;
1282		- endif;
1283		- echo "<strong>complete.</strong></li>\n";
1284		- endforeach;
1285		- echo "</ul>\n";
1286		-
1287	1930	// Mark the upgrade as successful.
1288	1931	update_option('feedwordpress_version', FEEDWORDPRESS_VERSION);
1289	1932	endswitch;
1290	1933	echo "<p>Upgrade complete. FeedWordPress is now ready to use again.</p>";
		@@ -1289,130 +1932,560 @@
1289	1932	endswitch;
1290	1933	echo "<p>Upgrade complete. FeedWordPress is now ready to use again.</p>";
1291	1934	} /* FeedWordPress::upgrade_database() */
1292	1935
1293		- function create_guid_index () {
	1936	+ public static function has_guid_index () {
1294	1937	global $wpdb;
1295		-
	1938	+
	1939	+ $found = false; // Guilty until proven innocent.
	1940	+
	1941	+ $results = $wpdb->get_results("
	1942	+ SHOW INDEXES FROM {$wpdb->posts}
	1943	+ ");
	1944	+ if ($results) :
	1945	+ foreach ($results as $index) :
	1946	+ if (isset($index->Column_name)
	1947	+ and ('guid' == $index->Column_name)) :
	1948	+ $found = true;
	1949	+ endif;
	1950	+ endforeach;
	1951	+ endif;
	1952	+ return $found;
	1953	+ } /* FeedWordPress::has_guid_index () */
	1954	+
	1955	+ public static function create_guid_index () {
	1956	+ global $wpdb;
	1957	+
1296	1958	$wpdb->query("
1297	1959	CREATE INDEX {$wpdb->posts}_guid_idx ON {$wpdb->posts}(guid)
1298	1960	");
1299	1961	} /* FeedWordPress::create_guid_index () */
1300		-
1301		- function clear_cache () {
	1962	+
	1963	+ public static function remove_guid_index () {
1302	1964	global $wpdb;
1303		-
1304		- // MagpieRSS stores its cached feeds in options table rows with
1305		- // name = `rss_{md5 of url}` and timestamps for cached feeds in
1306		- // table rows with name = `rss_{md5 of url}_ts`. The md5 is
1307		- // always 32 characters in length, so the total option_name is
1308		- // always over 32 characters.
	1965	+
1309	1966	$wpdb->query("
	1967	+ DROP INDEX {$wpdb->posts}_guid_idx ON {$wpdb->posts}
	1968	+ ");
	1969	+ }
	1970	+
	1971	+ static function fetch_timeout () {
	1972	+ return apply_filters(
	1973	+ 'feedwordpress_fetch_timeout',
	1974	+ intval(get_option('feedwordpress_fetch_timeout', FEEDWORDPRESS_FETCH_TIMEOUT_DEFAULT))
	1975	+ );
	1976	+ }
	1977	+
	1978	+ static function fetch ($url, $params = array()) {
	1979	+ if (is_wp_error($url)) :
	1980	+ // Let's bounce.
	1981	+ return $url;
	1982	+ endif;
	1983	+
	1984	+ $force_feed = true; // Default
	1985	+
	1986	+ // Allow user to change default feed-fetch timeout with a global setting.
	1987	+ // Props Erigami Scholey-Fuller <http://www.piepalace.ca/blog/2010/11/feedwordpress-broke-my-heart.html>
	1988	+ $timeout = FeedWordPress::fetch_timeout();
	1989	+
	1990	+ if ( !is_array($params)) :
	1991	+ $force_feed = $params;
	1992	+ else : // Parameter array
	1993	+ $args = wp_parse_args(array(
	1994	+ 'force_feed' => $force_feed,
	1995	+ 'timeout' => $timeout
	1996	+ ), $params);
	1997	+
	1998	+ extract($args);
	1999	+ endif;
	2000	+ $timeout = intval($timeout);
	2001	+
	2002	+ $pie_class = apply_filters('feedwordpress_simplepie_class', 'FeedWordPie');
	2003	+ $cache_class = apply_filters('feedwordpress_cache_class', 'FeedWordPie_Cache');
	2004	+ $file_class = apply_filters('feedwordpress_file_class', 'FeedWordPie_File');
	2005	+ $parser_class = apply_filters('feedwordpress_parser_class', 'FeedWordPie_Parser');
	2006	+ $item_class = apply_filters('feedwordpress_item_class', 'FeedWordPie_Item');
	2007	+ $sniffer_class = apply_filters('feedwordpress_sniffer_class', 'FeedWordPie_Content_Type_Sniffer');
	2008	+
	2009	+ $feed = new $pie_class;
	2010	+ $feed->set_feed_url($url);
	2011	+ $feed->registry->register('Cache', $cache_class);
	2012	+ $feed->set_timeout($timeout);
	2013	+
	2014	+ $feed->set_content_type_sniffer_class($sniffer_class);
	2015	+ $feed->set_file_class($file_class);
	2016	+ $feed->set_parser_class($parser_class);
	2017	+ $feed->set_item_class($item_class);
	2018	+ $feed->force_feed($force_feed);
	2019	+ $feed->set_cache_duration(FeedWordPress::cache_duration($params));
	2020	+ $feed->init();
	2021	+ $feed->handle_content_type();
	2022	+
	2023	+ if ($feed->error()) :
	2024	+ $ret = new WP_Error('simplepie-error', $feed->error());
	2025	+ else :
	2026	+ $ret = $feed;
	2027	+ endif;
	2028	+ return $ret;
	2029	+ } /* FeedWordPress::fetch () */
	2030	+
	2031	+ public function clear_cache () {
	2032	+ global $wpdb;
	2033	+
	2034	+ // Just in case, clear out any old MagpieRSS cache records.
	2035	+ $magpies = $wpdb->query("
1310	2036	DELETE FROM {$wpdb->options}
1311		- WHERE LOCATE('rss_', option_name) AND LENGTH(option_name) > 32
	2037	+ WHERE option_name LIKE 'rss_%' AND LENGTH(option_name) > 32
1312	2038	");
	2039	+
	2040	+ // The WordPress SimplePie module stores its cached feeds as
	2041	+ // transient records in the options table. The data itself is
	2042	+ // stored in `_transient_feed_{md5 of url}` and the last-modified
	2043	+ // timestamp in `_transient_feed_mod_{md5 of url}`. Timeouts for
	2044	+ // these records are stored in `_transient_timeout_feed_{md5}`.
	2045	+ // Since the md5 is always 32 characters in length, the
	2046	+ // option_name is always over 32 characters.
	2047	+ $simplepies = $wpdb->query("
	2048	+ DELETE FROM {$wpdb->options}
	2049	+ WHERE option_name LIKE '_transient%_feed_%' AND LENGTH(option_name) > 32
	2050	+ ");
	2051	+ $simplepies = (int) ($simplepies / 4); // Each transient has 4 rows: the data, the modified timestamp; and the timeouts for each
	2052	+
	2053	+ return ($magpies + $simplepies);
1313	2054	} /* FeedWordPress::clear_cache () */
1314	2055
1315		- function magpie_version () {
1316		- if (!defined('MAGPIE_VERSION')) : $magpie_version = $GLOBALS['wp_version'].'-default';
1317		- else : $magpie_version = MAGPIE_VERSION;
	2056	+ static public function cache_duration ($params = array()) {
	2057	+ $params = wp_parse_args($params, array(
	2058	+ "cache" => true,
	2059	+ ));
	2060	+
	2061	+ $duration = null;
	2062	+ if ( ! $params['cache']) :
	2063	+ $duration = 0;
	2064	+ elseif (defined('FEEDWORDPRESS_CACHE_AGE')) :
	2065	+ $duration = FEEDWORDPRESS_CACHE_AGE;
1318	2066	endif;
1319		- return $magpie_version;
	2067	+ return $duration;
1320	2068	}
1321	2069
	2070	+ static public function cache_lifetime ($duration) {
	2071	+ // Check for explicit setting of a lifetime duration
	2072	+ if (defined('FEEDWORDPRESS_CACHE_LIFETIME')) :
	2073	+ $duration = FEEDWORDPRESS_CACHE_LIFETIME;
	2074	+
	2075	+ // Fall back to the cache freshness duration
	2076	+ elseif (defined('FEEDWORDPRESS_CACHE_AGE')) :
	2077	+ $duration = FEEDWORDPRESS_CACHE_AGE;
	2078	+ endif;
	2079	+
	2080	+ // Fall back to WordPress default
	2081	+ return $duration;
	2082	+ } /* FeedWordPress::cache_lifetime () */
	2083	+
1322	2084	# Utility functions for handling text settings
1323		- function negative ($f, $setting) {
	2085	+ static function get_field( $f, $setting = null ) {
	2086	+
	2087	+ $ret = $f;
	2088	+ if ( ! is_null( $setting ) ) :
	2089	+ $ret = null;
	2090	+ if ( array_key_exists( $setting, $f ) ) :
	2091	+ $ret = $f[ $setting ];
	2092	+ endif;
	2093	+ endif;
	2094	+ return $ret;
	2095	+
	2096	+ } /* FeedWordPress::get_field () */
	2097	+
	2098	+ static function negative ($f, $setting = null) {
1324	2099	$nego = array ('n', 'no', 'f', 'false');
1325		- return (isset($f[$setting]) and in_array(strtolower($f[$setting]), $nego));
1326		- }
	2100	+ $q = self::get_field( $f, $setting );
	2101	+ return in_array( strtolower( trim( $q ) ), $nego );
	2102	+ } /* FeedWordPress::negative () */
1327	2103
1328		- function affirmative ($f, $setting) {
	2104	+ static function affirmative ($f, $setting = null) {
1329	2105	$affirmo = array ('y', 'yes', 't', 'true', 1);
1330		- return (isset($f[$setting]) and in_array(strtolower($f[$setting]), $affirmo));
1331		- }
	2106	+ $q = self::get_field( $f, $setting );
	2107	+ return in_array( strtolower( trim( $q ) ), $affirmo );
	2108	+ } /* FeedWordPress::affirmative () */
1332	2109
	2110	+ /**
	2111	+ * Internal debugging functions.
	2112	+ *
	2113	+ * @todo radgeek needs to document this better. What levels exist, and
	2114	+ * how/where are they defined? (gwyneth 20230919)
	2115	+ *
	2116	+ * @global $feedwordpress_admin_footer
	2117	+ */
	2118	+ static function diagnostic( $level, $out, $persist = null, $since = null, $mostRecent = null ) {
	2119	+ global $feedwordpress_admin_footer;
1333	2120
1334		- # Internal debugging functions
1335		- function critical_bug ($varname, $var, $line) {
1336		- global $wp_version;
	2121	+ $output = get_option( 'feedwordpress_diagnostics_output', array() );
	2122	+ $dlog = get_option( 'feedwordpress_diagnostics_log', array() );
1337	2123
1338		- if (defined('MAGPIE_VERSION')) : $mv = MAGPIE_VERSION;
1339		- else : $mv = 'WordPress '.$wp_version.' default.';
	2124	+ $diagnostic_nesting = count( explode( ":", $level ) );
	2125	+
	2126	+ if (FeedWordPressDiagnostic::is_on($level)) :
	2127	+ foreach ($output as $method) :
	2128	+ switch ($method) :
	2129	+ case 'echo' :
	2130	+ if ( !( self::update_requested() || wp_doing_ajax() ) ) :
	2131	+ echo "<div><pre><strong>Diag".esc_html( str_repeat('====', $diagnostic_nesting-1) ).'|</strong> '. esc_html( $out )."</pre></div>\n";
	2132	+ endif;
	2133	+ break;
	2134	+ case 'echo_in_cronjob' :
	2135	+ if (self::update_requested()) :
	2136	+ echo esc_html( self::log_prefix() ) . ' ' . esc_html( $out ) . "\n";
	2137	+ endif;
	2138	+ break;
	2139	+ case 'admin_footer' :
	2140	+ $feedwordpress_admin_footer[] = $out;
	2141	+ break;
	2142	+ case 'error_log' :
	2143	+ error_log(self::log_prefix() . ' ' . $out);
	2144	+ break;
	2145	+ case 'email' :
	2146	+
	2147	+ if (is_null($persist)) :
	2148	+ $sect = 'occurrent';
	2149	+ $hook = (isset($dlog['mesg'][$sect]) ? count($dlog['mesg'][$sect]) : 0);
	2150	+ $line = array("Time" => time(), "Message" => $out);
	2151	+ else :
	2152	+ $sect = 'persistent';
	2153	+ $hook = md5($level."\n".$persist);
	2154	+ $line = array("Since" => $since, "Message" => $out, "Most Recent" => $mostRecent);
	2155	+ endif;
	2156	+
	2157	+ if ( !isset($dlog['mesg'])) : $dlog['mesg'] = array(); endif;
	2158	+ if ( !isset($dlog['mesg'][$sect])) : $dlog['mesg'][$sect] = array(); endif;
	2159	+
	2160	+ $dlog['mesg'][$sect][$hook] = $line;
	2161	+ endswitch;
	2162	+ endforeach;
1340	2163	endif;
1341	2164
1342		- echo '<p>There may be a bug in FeedWordPress. Please <a href="'.FEEDWORDPRESS_AUTHOR_CONTACT.'">contact the author</a> and paste the following information into your e-mail:</p>';
1343		- echo "\n<plaintext>";
1344		- echo "Triggered at line # ".$line."\n";
1345		- echo "FeedWordPress version: ".FEEDWORDPRESS_VERSION."\n";
1346		- echo "MagpieRSS version: {$mv}\n";
1347		- echo "WordPress version: {$wp_version}\n";
1348		- echo "PHP version: ".phpversion()."\n";
1349		- echo "\n";
1350		- echo $varname.": "; var_dump($var); echo "\n";
1351		- die;
	2165	+ update_option( 'feedwordpress_diagnostics_log', $dlog );
	2166	+ } /* FeedWordPress::diagnostic() */
	2167	+
	2168	+ public function email_diagnostics_override () {
	2169	+ return ( $this->has_secret() and ! ! FeedWordPress::param( 'feedwordpress_email_diagnostics' ) );
	2170	+ } /* FeedWordPress::email_diagnostics_override() */
	2171	+
	2172	+ public function has_emailed_diagnostics ($dlog) {
	2173	+ $ret = false;
	2174	+ if ($this->email_diagnostics_override()
	2175	+ or (isset($dlog['schedule']) and isset($dlog['schedule']['last']))) :
	2176	+ $ret = true;
	2177	+ endif;
	2178	+ return $ret;
	2179	+ } /* FeedWordPress::has_emailed_diagnostics() */
	2180	+
	2181	+ public function ready_to_email_diagnostics ($dlog) {
	2182	+ $ret = false;
	2183	+ if ($this->email_diagnostics_override()
	2184	+ or (time() > ($dlog['schedule']['last'] + $dlog['schedule']['freq']))) :
	2185	+ $ret = true;
	2186	+ endif;
	2187	+ return $ret;
	2188	+ } /* FeedWordPress::ready_to_email_diagnostics() */
	2189	+
	2190	+ /**
	2191	+ * Emails a diagnostic log to the WP administrator.
	2192	+ *
	2193	+ * @param Array $params See @wp_parse_args()
	2194	+ */
	2195	+ public function email_diagnostic_log( $params = array() ) {
	2196	+ $params = wp_parse_args( $params, array(
	2197	+ "force" => false,
	2198	+ ) );
	2199	+
	2200	+ $dlog = get_option('feedwordpress_diagnostics_log', array());
	2201	+
	2202	+ if ($this->has_emailed_diagnostics($dlog)) :
	2203	+ if ($this->ready_to_email_diagnostics($dlog)) :
	2204	+ // No news is good news; only send if
	2205	+ // there are some messages to send.
	2206	+ $body = null;
	2207	+ if ( !isset($dlog['mesg'])) : $dlog['mesg'] = array(); endif;
	2208	+
	2209	+ foreach ($dlog['mesg'] as $sect => $mesgs) :
	2210	+ if (count($mesgs) > 0) :
	2211	+ if (is_null($body)) : $body = ''; endif;
	2212	+
	2213	+ $paradigm = reset($mesgs);
	2214	+ $body .= "<h2>".ucfirst($sect)." issues</h2>\n"
	2215	+ ."<table>\n"
	2216	+ ."<thead><tr>\n";
	2217	+ foreach ( $paradigm as $col => $value ) :
	2218	+ $body .= '<th scope="col">'.$col."</th>\n";
	2219	+ endforeach;
	2220	+ $body .= "</tr></thead>\n"
	2221	+ ."<tbody>\n";
	2222	+
	2223	+ foreach ($mesgs as $line) :
	2224	+ $body .= "<tr>\n";
	2225	+ foreach ($line as $col => $cell) :
	2226	+ if (is_numeric($cell)) :
	2227	+ $cell = date('j-M-y, h:i a', $cell);
	2228	+ endif;
	2229	+ $class = strtolower(preg_replace('/\s+/', '-', $col));
	2230	+ $body .= "<td class=\"$class\">{$cell}</td>";
	2231	+ endforeach;
	2232	+ $body .= "</tr>\n";
	2233	+ endforeach;
	2234	+
	2235	+ $body .= "</tbody>\n</table>\n\n";
	2236	+ endif;
	2237	+ endforeach;
	2238	+
	2239	+ $body = apply_filters('feedwordpress_diagnostic_email_body', $body, $dlog);
	2240	+ if ( !is_null($body)) :
	2241	+ $home = feedwordpress_display_url(get_bloginfo('url'));
	2242	+ $subj = apply_filters('feedwordpress_diagnostic_email_subject', $home . " syndication issues", $dlog);
	2243	+ $agent = 'FeedWordPress '.FEEDWORDPRESS_VERSION;
	2244	+ $body = <<<EOMAIL
	2245	+<html>
	2246	+<head>
	2247	+<title>$subj</title>
	2248	+<style type="text/css">
	2249	+ body { background-color: white; color: black; }
	2250	+ table { width: 100%; border: 1px solid black; }
	2251	+ table thead tr th { background-color: #ff7700; color: white; border-bottom: 1px solid black; }
	2252	+ table thead tr { border-bottom: 1px solid black; }
	2253	+ table tr { vertical-align: top; }
	2254	+ table .since { width: 20%; }
	2255	+ table .time { width: 20%; }
	2256	+ table .most-recently { width: 20%; }
	2257	+ table .message { width: auto; }
	2258	+</style>
	2259	+</head>
	2260	+<body>
	2261	+<h1>Syndication Issues encountered by $agent on $home</h1>
	2262	+$body
	2263	+</body>
	2264	+</html>
	2265	+
	2266	+EOMAIL;
	2267	+
	2268	+ $ded = get_option('feedwordpress_diagnostics_email_destination', 'admins');
	2269	+
	2270	+ // e-mail address
	2271	+ if (preg_match('/^mailto:(.*)$/', $ded, $ref)) :
	2272	+ $recipients = array($ref[1]);
	2273	+
	2274	+ // userid
	2275	+ elseif (preg_match('/^user:(.*)$/', $ded, $ref)) :
	2276	+ if ( is_numeric( $ref[1] ) and function_exists( 'get_userdata' ) ) :
	2277	+ $userdata = get_userdata( (int) $ref[1]) ;
	2278	+ $recipients = array( $userdata->user_email );
	2279	+ else :
	2280	+ // get_userdata() might not have been loaded yet, so send
	2281	+ // to admins instead. (gwyneth 20230901)
	2282	+ $recipients = FeedWordPressDiagnostic::admin_emails();
	2283	+ endif;
	2284	+
	2285	+ // admins
	2286	+ else :
	2287	+ $recipients = FeedWordPressDiagnostic::admin_emails();
	2288	+ endif;
	2289	+
	2290	+ $mesgId = 'feedwordpress+'.time().'@'.$home;
	2291	+ $parentId = get_option('feedwordpress_diagnostics_email_root_message_id', null);
	2292	+
	2293	+ $head = array("Message-ID: <$mesgId>");
	2294	+ if ( !is_null($parentId)) :
	2295	+ // We've already sent off a diagnostic message in the past. Let's do some
	2296	+ // magic to help with threading, in the hopes that all diagnostic messages
	2297	+ // get threaded together.
	2298	+ $head[] = "References: <$parentId>";
	2299	+ $head[] = "In-Reply-To: <$parentId>";
	2300	+ $subj = "Re: ".$subj;
	2301	+ else :
	2302	+ // This is the first of its kind. Let's mark it as such.
	2303	+ update_option('feedwordpress_diagnostics_email_root_message_id', $mesgId);
	2304	+ endif;
	2305	+ $head = apply_filters('feedwordpress_diagnostic_email_headers', $head);
	2306	+
	2307	+ foreach ($recipients as $email) :
	2308	+ add_filter('wp_mail_content_type', array('FeedWordPress', 'allow_html_mail'));
	2309	+ wp_mail($email, $subj, $body, $head);
	2310	+ remove_filter('wp_mail_content_type', array('FeedWordPress', 'allow_html_mail'));
	2311	+ endforeach;
	2312	+ endif;
	2313	+
	2314	+ // Clear the logs
	2315	+ $dlog['mesg']['persistent'] = array();
	2316	+ $dlog['mesg']['occurrent'] = array();
	2317	+
	2318	+ // Set schedule for next update
	2319	+ $dlog['schedule']['last'] = time();
	2320	+ endif;
	2321	+ else :
	2322	+ $dlog['schedule'] = array(
	2323	+ 'freq' => 24 /*hr*/ * 60 /*min*/ * 60 /*s*/,
	2324	+ 'last' => time(),
	2325	+ );
	2326	+ endif;
	2327	+
	2328	+ update_option( 'feedwordpress_diagnostics_log', $dlog );
	2329	+ } /* FeedWordPress::email_diagnostic_log () */
	2330	+
	2331	+
	2332	+ static function allow_html_mail() {
	2333	+ return 'text/html';
	2334	+ } /* FeedWordPress::allow_html_mail () */
	2335	+
	2336	+ static function admin_footer () {
	2337	+ global $feedwordpress_admin_footer;
	2338	+ foreach ($feedwordpress_admin_footer as $line) :
	2339	+ echo '<div><pre>' . esc_html( $line ) . '</pre></div>';
	2340	+ endforeach;
	2341	+ } /* FeedWordPress::admin_footer () */
	2342	+
	2343	+ /**
	2344	+ * Returns the log prefix, optionally with a date.
	2345	+ *
	2346	+ * @param boolean $date If true, a date timestamp is added to the prefix.
	2347	+ * @return string Generated log prefix.
	2348	+ */
	2349	+ static function log_prefix ($date = false) {
	2350	+ $home = get_bloginfo('url');
	2351	+ $prefix = '['.feedwordpress_display_url($home).'] [feedwordpress] ';
	2352	+ if ($date) :
	2353	+ $prefix = "[".date('Y-m-d H:i:s')."]".$prefix;
	2354	+ endif;
	2355	+ return $prefix;
	2356	+ } /* FeedWordPress::log_prefix () */
	2357	+
	2358	+ /**
	2359	+ * Returns the menu capacity value.
	2360	+ *
	2361	+ * @param boolean $sub If true, we're on a menu sublevel.
	2362	+ * @return mixed Returns the capacity.
	2363	+ */
	2364	+ static function menu_cap ($sub = false) {
	2365	+ if ($sub) :
	2366	+ $cap = apply_filters('feedwordpress_menu_settings_capacity', 'manage_options');
	2367	+ else :
	2368	+ $cap = apply_filters('feedwordpress_menu_main_capacity', 'manage_links');
	2369	+ endif;
	2370	+ return $cap;
	2371	+ } /* FeedWordPress::menu_cap () */
	2372	+
	2373	+ public function plugin_dir_path ($path = '') {
	2374	+ $dir = plugin_dir_path( __FILE__ );
	2375	+ $file_path = "{$dir}{$path}";
	2376	+ return apply_filters( "feedwordpress_plugin_dir_path", $file_path );
	2377	+ } /* FeedWordPress::plugin_dir_path () */
	2378	+
	2379	+ public function plugin_dir_url ($path = '') {
	2380	+ $url_path = plugins_url( $path, __FILE__ );
	2381	+ return apply_filters( "feedwordpress_plugin_dir_url", $url_path );
	2382	+ } /* FeedWordPRess::plugin_dir_url () */
	2383	+
	2384	+ static function path ($filename = '') {
	2385	+ global $fwp_path;
	2386	+
	2387	+ $path = $fwp_path;
	2388	+ if (strlen($filename) > 0) :
	2389	+ $path .= '/'.$filename;
	2390	+ endif;
	2391	+
	2392	+ return $path;
	2393	+ } /* FeedWordPress::path () */
	2394	+
	2395	+ // -- DEPRCATED UTILITY FUNCTIONS -------------------------------------
	2396	+ // These are superceded by later code re-organization, (for example
	2397	+ // MyPHP::param/post/get/request, or FeedWordPressDiagnostic methods),
	2398	+ // but for the last several versions have been kept here for backward
	2399	+ // compatibility with add-ons, older code, etc. Maybe someday they
	2400	+ // will go away.
	2401	+ // -------------------------------------------------------------------
	2402	+ static function param( $key, $type = 'REQUEST', $default = null, $sanitizer = null ) {
	2403	+ return self::sanitized_parameter( MyPHP::param( $key, $default, $type ), $sanitizer );
	2404	+ } /* FeedWordPress::param () */
	2405	+
	2406	+ static function post( $key, $default = null, $sanitizer = null ) {
	2407	+ return self::sanitized_parameter( MyPHP::post( $key, $default ), $sanitizer );
	2408	+ } /* FeedWordPress::post () */
	2409	+
	2410	+ static function shallow_sanitize( $item, $sanitizer = null ) {
	2411	+ if ( $sanitizer == 'raw' ) :
	2412	+ $value = $item;
	2413	+ elseif ( $sanitizer == 'textarea' ) :
	2414	+ $value = sanitize_textarea_field( $item );
	2415	+ else :
	2416	+ $value = sanitize_text_field( $item );
	2417	+ endif;
	2418	+ return $value;
1352	2419	}
1353		-
1354		- function noncritical_bug ($varname, $var, $line) {
1355		- if (FEEDWORDPRESS_DEBUG) : // halt only when we are doing debugging
1356		- FeedWordPress::critical_bug($varname, $var, $line);
	2420	+
	2421	+ static function sanitized_parameter( $value, $sanitizer = null ) {
	2422	+ if ( $sanitizer === 'raw' || is_scalar( $value ) ) :
	2423	+ $ret = self::shallow_sanitize( $value, $sanitizer );
	2424	+ elseif ( is_array( $value ) ) :
	2425	+ $ret = array();
	2426	+ foreach ( $value as $key => $item ) :
	2427	+ $ret[ $key ] = self::sanitized_parameter( $item, $sanitizer );
	2428	+ endforeach;
	2429	+ else :
	2430	+ $ret = null; // "Sanitized" objects or resources currently get nothing.
1357	2431	endif;
	2432	+ return $ret;
1358	2433	}
1359		-} // class FeedWordPress
1360	2434
1361		-require_once(dirname(__FILE__) . '/syndicatedpost.class.php');
1362		-require_once(dirname(__FILE__) . '/syndicatedlink.class.php');
	2435	+ static function val ($v, $no_newlines = false) {
	2436	+ return MyPHP::val($v, $no_newlines);
	2437	+ } /* FeedWordPress::val () */
1363	2438
1364		-################################################################################
1365		-## XML-RPC HOOKS: accept XML-RPC update pings from Contributors ################
1366		-################################################################################
	2439	+ static function critical_bug ($varname, $var, $line, $file = null) {
	2440	+ FeedWordPressDiagnostic::critical_bug($varname, $var, $line, $file);
	2441	+ } /* FeedWordPress::critical_bug () */
1367	2442
1368		-function feedwordpress_xmlrpc_hook ($args = array ()) {
1369		- $args['weblogUpdates.ping'] = 'feedwordpress_pong';
1370		- return $args;
1371		-}
	2443	+ static function noncritical_bug ($varname, $var, $line, $file = null) {
	2444	+ FeedWordPressDiagnostic::noncritical_bug($varname, $var, $line, $file);
	2445	+ } /* FeedWordPress::noncritical_bug () */
1372	2446
1373		-function feedwordpress_pong ($args) {
1374		- $feedwordpress =& new FeedWordPress;
1375		- $delta = @$feedwordpress->update($args[1]);
1376		- if (is_null($delta)):
1377		- return array('flerror' => true, 'message' => "Sorry. I don't syndicate <$args[1]>.");
1378		- else:
1379		- $mesg = array();
1380		- if (isset($delta['new'])) { $mesg[] = ' '.$delta['new'].' new posts were syndicated'; }
1381		- if (isset($delta['updated'])) { $mesg[] = ' '.$delta['updated'].' existing posts were updated'; }
	2447	+ static function diagnostic_on ($level) {
	2448	+ return FeedWordPressDiagnostic::is_on($level);
	2449	+ } /* FeedWordPress::diagnostic_on () */
1382	2450
1383		- return array('flerror' => false, 'message' => "Thanks for the ping.".implode(' and', $mesg));
1384		- endif;
1385		-}
	2451	+} /* class FeedWordPress */
1386	2452
1387		-# The upgraded MagpieRSS also uses this class. So if we have it loaded
1388		-# in, don't load it again.
1389		-if (!class_exists('Relative_URI')) {
1390		- require_once(dirname(__FILE__) . '/relative_uri.class.php');
1391		-}
	2453	+$feedwordpress_admin_footer = array();
1392	2454
1393	2455	// take your best guess at the realname and e-mail, given a string
1394		-define('FWP_REGEX_EMAIL_ADDY', '([^@"(<\s]+@[^"@(<\s]+\.[^"@(<\s]+)');
1395		-define('FWP_REGEX_EMAIL_NAME', '("([^"]*)"|([^"<(]+\S))');
1396		-define('FWP_REGEX_EMAIL_POSTFIX_NAME', '/^\s*'.FWP_REGEX_EMAIL_ADDY."\s+\(".FWP_REGEX_EMAIL_NAME.'\)\s*$/');
1397		-define('FWP_REGEX_EMAIL_PREFIX_NAME', '/^\s*'.FWP_REGEX_EMAIL_NAME.'\s*<'.FWP_REGEX_EMAIL_ADDY.'>\s*$/');
1398		-define('FWP_REGEX_EMAIL_JUST_ADDY', '/^\s*'.FWP_REGEX_EMAIL_ADDY.'\s*$/');
1399		-define('FWP_REGEX_EMAIL_JUST_NAME', '/^\s*'.FWP_REGEX_EMAIL_NAME.'\s*$/');
	2456	+define( 'FWP_REGEX_EMAIL_ADDY', '([^@"(<\s]+@[^"@(<\s]+\.[^"@(<\s]+)' );
	2457	+define( 'FWP_REGEX_EMAIL_NAME', '("([^"]*)"|([^"<(]+\S))' );
	2458	+define( 'FWP_REGEX_EMAIL_POSTFIX_NAME', '/^\s*' . FWP_REGEX_EMAIL_ADDY . '\s+\(' . FWP_REGEX_EMAIL_NAME . '\)\s*$/' );
	2459	+define( 'FWP_REGEX_EMAIL_PREFIX_NAME', '/^\s*' . FWP_REGEX_EMAIL_NAME . '\s*<' . FWP_REGEX_EMAIL_ADDY . '>\s*$/' );
	2460	+define( 'FWP_REGEX_EMAIL_JUST_ADDY', '/^\s*' . FWP_REGEX_EMAIL_ADDY . '\s*$/' );
	2461	+define( 'FWP_REGEX_EMAIL_JUST_NAME', '/^\s*' . FWP_REGEX_EMAIL_NAME . '\s*$/' );
1400	2462
1401		-function parse_email_with_realname ($email) {
1402		- if (preg_match(FWP_REGEX_EMAIL_POSTFIX_NAME, $email, $matches)) :
1403		- ($ret['name'] = $matches[3]) or ($ret['name'] = $matches[2]);
	2463	+/**
	2464	+ * Parses an email address that includes the real name as well.
	2465	+ *
	2466	+ * @param string $email Email address to parse.
	2467	+ *
	2468	+ * @return array Associative array with 'name' and 'email' as fields (each may be null).
	2469	+ */
	2470	+function parse_email_with_realname( $email ) {
	2471	+ $ret = array(
	2472	+ 'name' => null,
	2473	+ 'email' => null
	2474	+ ); // avoid uninitialized variables for return values, this will generate a notice/warning - and one day, an error! (gwyneth 20210714)
	2475	+
	2476	+ if ( preg_match( FWP_REGEX_EMAIL_POSTFIX_NAME, $email, $matches ) ) :
	2477	+ ( $ret['name'] = $matches[3] ) || ( $ret['name'] = $matches[2] );
1404	2478	$ret['email'] = $matches[1];
1405		- elseif (preg_match(FWP_REGEX_EMAIL_PREFIX_NAME, $email, $matches)) :
1406		- ($ret['name'] = $matches[2]) or ($ret['name'] = $matches[3]);
	2479	+ elseif ( preg_match( FWP_REGEX_EMAIL_PREFIX_NAME, $email, $matches ) ) :
	2480	+ ( $ret['name'] = $matches[2] ) || ( $ret['name'] = $matches[3] );
1407	2481	$ret['email'] = $matches[4];
1408		- elseif (preg_match(FWP_REGEX_EMAIL_JUST_ADDY, $email, $matches)) :
1409		- $ret['name'] = NULL; $ret['email'] = $matches[1];
1410		- elseif (preg_match(FWP_REGEX_EMAIL_JUST_NAME, $email, $matches)) :
1411		- $ret['email'] = NULL;
1412		- ($ret['name'] = $matches[2]) or ($ret['name'] = $matches[3]);
1413		- else :
1414		- $ret['name'] = NULL; $ret['email'] = NULL;
	2482	+
	2483	+ elseif ( preg_match( FWP_REGEX_EMAIL_JUST_ADDY, $email, $matches ) ) :
	2484	+ $ret['name'] = null;
	2485	+ $ret['email'] = $matches[1];
	2486	+ elseif ( preg_match( FWP_REGEX_EMAIL_JUST_NAME, $email, $matches ) ) :
	2487	+ $ret['email'] = null;
	2488	+ ( $ret['name'] = $matches[2] ) || ( $ret['name'] = $matches[3] );
1415	2489	endif;
1416	2490	return $ret;
1417	2491	}
1418		-