{"id":32111,"date":"2014-10-04T15:20:09","date_gmt":"2014-10-04T15:20:09","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/featured-background\/"},"modified":"2025-09-04T19:18:31","modified_gmt":"2025-09-04T19:18:31","slug":"featured-background","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/featured-background\/","author":79136,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0","stable_tag":"1.0","tested":"6.8.5","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Featured Background","header_author":"Schwarttzy","header_description":"","assets_banners_color":"5b6865","last_updated":"2025-09-04 19:18:31","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/featured-background\/","header_author_uri":"http:\/\/schwarttzy.com\/","rating":4,"author_block_rating":0,"active_installs":30,"downloads":2771,"num_ratings":4,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.2":{"tag":"0.2","author":"Schwarttzy","date":"2014-10-04 15:23:26"},"0.3":{"tag":"0.3","author":"Schwarttzy","date":"2014-10-04 16:26:08"},"0.4":{"tag":"0.4","author":"Schwarttzy","date":"2014-10-04 16:29:32"},"0.5":{"tag":"0.5","author":"Schwarttzy","date":"2014-10-04 16:43:38"},"0.6":{"tag":"0.6","author":"Schwarttzy","date":"2014-10-04 16:48:59"},"1.0":{"tag":"1.0","author":"Schwarttzy","date":"2025-09-04 19:18:31"}},"upgrade_notice":{"1.0":"<p>Major feature additions including parallax, overlays, CPT support, and Gutenberg integration. Back up your site before upgrading. Test on a staging site if possible.<\/p>"},"ratings":{"1":"1","2":0,"3":0,"4":0,"5":"3"},"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":3356298,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3356298,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3356298,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3356298,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.2","0.3","0.4","0.5","0.6","1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":1001767,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":1001767,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"The enhanced \"Featured Background\" meta box with options.","2":"Gutenberg sidebar integration.","3":"Settings page for CPT support.","4":"Front-end example with overlay and parallax."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2767,8628,1795,21450,247421],"plugin_category":[50],"plugin_contributors":[89177],"plugin_business_model":[],"class_list":["post-32111","plugin","type-plugin","status-publish","hentry","plugin_tags-background","plugin_tags-custom-background","plugin_tags-featured-image","plugin_tags-page-background","plugin_tags-post-background","plugin_category-media","plugin_contributors-schwarttzy","plugin_committers-schwarttzy"],"banners":{"banner":"https:\/\/ps.w.org\/featured-background\/assets\/banner-772x250.jpg?rev=3356298","banner_2x":"https:\/\/ps.w.org\/featured-background\/assets\/banner-1544x500.jpg?rev=3356298","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/featured-background\/assets\/icon-128x128.jpg?rev=3356298","icon_2x":"https:\/\/ps.w.org\/featured-background\/assets\/icon-256x256.jpg?rev=3356298","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/featured-background\/assets\/screenshot-1.png?rev=1001767","caption":"The enhanced \"Featured Background\" meta box with options."},{"src":"https:\/\/ps.w.org\/featured-background\/assets\/screenshot-2.png?rev=1001767","caption":"Gutenberg sidebar integration."}],"raw_content":"<!--section=description-->\n<p><strong>Featured Background<\/strong> is a lightweight WordPress plugin that lets you set a custom background image for specific posts or pages using the built-in featured image functionality. Now enhanced with expanded options for customization, parallax effects via CSS, overlay colors, custom post type support, Gutenberg sidebar integration, and UI improvements.<\/p>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li><strong>Expanded Background Options<\/strong>: Customize position, repeat, size, attachment, and fallback color.<\/li>\n<li><strong>Parallax Effect<\/strong>: Simple CSS-based parallax (using fixed attachment) with an optional toggle.<\/li>\n<li><strong>Overlay Color and Opacity<\/strong>: Add a semi-transparent overlay for better text readability.<\/li>\n<li><strong>Custom Post Type Support<\/strong>: Enable the meta box on any public CPT via a settings page.<\/li>\n<li><strong>Gutenberg Integration<\/strong>: Dedicated plugin sidebar in the block editor for seamless configuration.<\/li>\n<li><strong>UI Improvements<\/strong>: Added \"Remove Image\" button and live preview in the meta box.<\/li>\n<li><strong>Simple Integration<\/strong>: Easily upload or select an image via the WordPress media library.<\/li>\n<li><strong>Automatic CSS Injection<\/strong>: Injects inline CSS into the header with options applied to the <code>body<\/code> element.<\/li>\n<li><strong>Admin Preview<\/strong>: Live preview in the editor.<\/li>\n<li><strong>Secure and Efficient<\/strong>: Nonces, sanitization, conditional enqueuing.<\/li>\n<li><strong>Clean Uninstall<\/strong>: Removes all data on deletion.<\/li>\n<li><strong>Modern Compatibility<\/strong>: Tested with WordPress 6.8.2 and PHP 8+.<\/li>\n<\/ul>\n\n<p>Ideal for personalizing backgrounds per page. The CSS includes comments for identification.<\/p>\n\n<p>Report issues on the <a href=\"https:\/\/wordpress.org\/support\/plugin\/featured-background\/\">support forum<\/a>.<\/p>\n\n<!--section=installation-->\n<h4>Minimum Requirements<\/h4>\n\n<ul>\n<li>WordPress 6.0 or higher<\/li>\n<li>PHP 7.4 or higher<\/li>\n<\/ul>\n\n<h4>Automatic Installation<\/h4>\n\n<ol>\n<li>Go to your WordPress dashboard: Plugins &gt; Add New.<\/li>\n<li>Search for \"Featured Background\".<\/li>\n<li>Click \"Install Now\" and then \"Activate\".<\/li>\n<\/ol>\n\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Download the plugin ZIP file from the WordPress.org plugin directory.<\/li>\n<li>In your WordPress dashboard, go to Plugins &gt; Add New &gt; Upload Plugin.<\/li>\n<li>Upload the ZIP file and click \"Install Now\".<\/li>\n<li>Activate the plugin.<\/li>\n<\/ol>\n\n<p>After activation:\n1. Go to Settings &gt; Featured Background to select supported post types.\n2. Edit a supported post or page.\n3. Use the \"Featured Background\" meta box or Gutenberg sidebar to set options.\n4. Save or update the post\/page\u2014the background will apply automatically on the front end.<\/p>\n\n<p>If permalinks or caching issues arise, flush your site's cache and regenerate permalinks via Settings &gt; Permalinks.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id='why%20isn%27t%20the%20background%20showing%3F'><h3>Why isn't the background showing?<\/h3><\/dt>\n<dd><p>Check image selection, save the post, and theme conflicts\u2014some themes may override body backgrounds with their own CSS. Clear your browser cache and test with a default theme like Twenty Twenty-Four.<\/p><\/dd>\n<dt id='how%20do%20i%20enable%20on%20custom%20post%20types%3F'><h3>How do I enable on custom post types?<\/h3><\/dt>\n<dd><p>Go to Settings &gt; Featured Background and select them from the list of public post types.<\/p><\/dd>\n<dt id='does%20this%20work%20with%20gutenberg%3F'><h3>Does this work with Gutenberg?<\/h3><\/dt>\n<dd><p>Yes, via a dedicated sidebar panel in the block editor.<\/p><\/dd>\n<dt id='how%20does%20the%20parallax%20work%3F'><h3>How does the parallax work?<\/h3><\/dt>\n<dd><p>It's a simple CSS effect using <code>background-attachment: fixed<\/code> when toggled on.<\/p><\/dd>\n<dt id='can%20i%20adjust%20the%20overlay%3F'><h3>Can I adjust the overlay?<\/h3><\/dt>\n<dd><p>Yes, choose the color and opacity (0-1) directly in the editor.<\/p><\/dd>\n<dt id='how%20do%20i%20remove%20the%20image%3F'><h3>How do I remove the image?<\/h3><\/dt>\n<dd><p>Use the \"Remove Image\" button in the meta box or Gutenberg sidebar.<\/p><\/dd>\n<dt id='does%20the%20plugin%20collect%20data%3F'><h3>Does the plugin collect data?<\/h3><\/dt>\n<dd><p>No, it doesn't track usage or collect personal data. All settings are stored locally in your database as post meta.<\/p>\n\n<p>For more questions, check the <a href=\"https:\/\/wordpress.org\/support\/plugin\/featured-background\/\">support forum<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0<\/h4>\n\n<ul>\n<li>Released: September 04, 2025<\/li>\n<li>Added expanded background options (position, repeat, size, attachment, fallback color).<\/li>\n<li>Implemented simple CSS parallax (fixed attachment toggle).<\/li>\n<li>Added custom post type support via settings page.<\/li>\n<li>Added overlay color and opacity.<\/li>\n<li>Integrated Gutenberg plugin sidebar.<\/li>\n<li>Added \"Remove Image\" button and UI improvements.<\/li>\n<li>Updated JS for color pickers and Gutenberg.<\/li>\n<li>Bumped version and tested up to 6.8.2.<\/li>\n<li>Enhanced uninstall to cover new meta.\\<\/li>\n<li>Major overhaul for modern compatibility.<\/li>\n<\/ul>","raw_excerpt":"Set a featured image as the background for individual posts or pages with advanced options like parallax, overlays, and more.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/32111","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=32111"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/schwarttzy"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=32111"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=32111"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=32111"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=32111"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=32111"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=32111"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}