feedwordpress / feedwordpress.php

feedwordpress.php in FeedWordPress 2021.0713, at feedwordpress.php

2,339 lines 78.9 KB

Raw Download Zip

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