Frontend feed rendering fatals with `Class "SimplePie\Misc" not found`

Summary

Rendering a Feedzy feed on the frontend can terminate with Error: Class "SimplePie\Misc" not found.

Expected behavior: the feed render completes or returns a handled feed error.

Actual behavior: the page request reaches an uncaught exception while Feedzy configures the feed user agent.

Impact: pages containing affected Feedzy shortcode feeds fail to render for the affected WordPress and PHP environments.

Customer context

• Product / area: Feedzy RSS Feeds frontend shortcode feed rendering
• Version: 5.2.7
• Environment: WordPress 6.3.8, 6.4.8, and 6.5.8; PHP 8.0.30 and 8.1.34
• Reported error / symptom: Error: Class "SimplePie\Misc" not found
• Impact: 7 telemetry occurrences across 3 production sites between 2026-08-04 and 2026-08-06.

Reproduction notes

1. Install Feedzy RSS Feeds 5.2.7 on an affected WordPress version from telemetry.
2. Render a frontend page containing [feedzy-rss] with a feed URL that does not contain medium.com.
3. Observed in production telemetry: the request terminates at get_default_user_agent() with Class "SimplePie\Misc" not found.

Direct local runtime reproduction was not run because the workspace has no configured WordPress test environment for the reported core versions.

Diagnosis

Conclusion

Production telemetry records an uncaught Class "SimplePie\Misc" not found exception at the same source line that the inspected v5.2.7 code invokes \SimplePie\Misc::get_default_useragent(). The stack reaches this call while rendering the [feedzy-rss] shortcode on a frontend request. This is confirmed as a Feedzy compatibility defect for the reported environments.

Where this likely occurs

• includes/abstract/feedzy-rss-feeds-admin-abstract.php — Feedzy_Rss_Feeds_Admin_Abstract::get_default_user_agent() lines 1301-1311 selects a Medium-specific constant, then invokes \SimplePie\Misc::get_default_useragent() for other sources; telemetry identifies line 1311 as the fatal location.
• includes/abstract/feedzy-rss-feeds-admin-abstract.php — Feedzy_Rss_Feeds_Admin_Abstract::configure_simplepie() lines 1157-1163 calls get_default_user_agent() before feed initialization, matching the reported stack path.
• includes/abstract/feedzy-rss-feeds-admin-abstract.php — Feedzy_Rss_Feeds_Admin_Abstract::init_single_feed() lines 896-902 reaches configure_simplepie() during normal single-feed rendering.
• Git commit 6655a944c4e2f0e7f331887a6f7b61d51ecfccf3 (fix: improve feed error handling, 2026-05-25) introduced the namespaced call. It is contained in tags from v5.1.7 through v5.2.7.

Engineering notes

• The telemetry is ground-truth runtime evidence that the referenced class is unavailable on the reported WordPress installations. WordPress core source was not present in this workspace, so the underlying SimplePie class layout was not independently checked here.
• The vulnerable branch is the fallback for feed URLs that do not match medium.com; configure_simplepie() reaches it before feed retrieval.
• The same namespaced call appears in the HTTP user-agent branches at lines 915 and 984, but the reported crash is independently confirmed at line 1311.

Test coverage status

• tests/test-shortcode-render.php contains shortcode render tests, including Test_Shortcode_Render::test_shortcode_renders_mocked_feed_items() at lines 159-180.
• tests/test-admin-abstract.php loads class-simplepie.php in Test_Abstract_Admin::setUp() at lines 19-31.
• No relevant coverage was found during inspection for the absent SimplePie\Misc class or the affected WordPress-version compatibility path.

What to verify or explore next

• Reproduce a non-Medium [feedzy-rss] shortcode render on WordPress 6.3.8, 6.4.8, and 6.5.8 with Feedzy 5.2.7.
• Check the SimplePie symbols loaded by each supported WordPress version during the frontend shortcode request.
• Exercise both single-feed and multiple-feed rendering with and without an incoming HTTP_USER_AGENT value.

Unknowns / follow-up

• The telemetry does not include the feed source URLs, so the exact source-host distribution is unavailable.
• The workspace does not contain WordPress core sources for a direct comparison of SimplePie availability across the reported core versions.

Confidence

Confidence: 99/100

The production telemetry supplies repeated frontend fatal-error evidence on three sites, and the v5.2.7 source unconditionally references the missing SimplePie\Misc class on the reported shortcode path. Git history places that reference in releases from v5.1.7 onward.

Crash telemetry

Occurrences	7
Distinct sites	3
First seen	2026-08-04 21:25 UTC
Last seen	2026-08-06 00:46 UTC
Crash location	product:includes/abstract/feedzy-rss-feeds-admin-abstract.php:1311
Request context	frontend
Inside Themeisle SDK	no
Product versions	5.2.7
WP versions	6.3.8, 6.4.8, 6.5.8
PHP versions	8.0.30, 8.1.34
SDK versions	3.3.58

---

Source: automated crash report — feedzy-rss-feeds, fingerprint 7406f6723de322486361230d7ac3f6f4
Generated by bug-report-triage (ID: bug-report-triage_6a7422fe748366.53321644)