# Globalnews Magazine **Version:** 1.0.0 **Architecture:** Hybrid Gutenberg theme **Requires:** WordPress 6.4 or later, PHP 7.4 or later **Text domain:** `globalnews-magazine` Globalnews Magazine rebuilds the supplied Globalnews news-template design as a native WordPress theme. Editorial pages use normal Gutenberg blocks, recurring story collections query WordPress Posts, and site-wide navigation and footer areas remain editable through WordPress administration. ## Installation 1. In WordPress, open **Appearance → Themes → Add New → Upload Theme**. 2. Upload the supplied `Globalnews-Magazine-1.0.0.zip` file. 3. Activate **Globalnews Magazine**. 4. Open the top-level **Import** screen and select **Import demo site**. 5. Review **Settings → Permalinks**. On a fresh site using plain permalinks, the importer selects `/%category%/%postname%/` and flushes rewrite rules once. The ZIP contains one theme root directory named `globalnews-magazine`. ## Demo import The idempotent importer reconstructs the demonstration site with native WordPress data: - 28 Posts with categories, tags, excerpts, featured images, editorial kickers, ratings, dates, and sample comments. - Pages for Home, an alternate homepage layout, News, About, Contact Us, Frequently Asked Questions, Gallery, Masonry News, and Privacy Policy. - Imported Media Library images, a custom logo, WordPress Site Icon, and advertisement images. - Primary, Utility, Footer, and Social menus with their theme-location assignments. - News-sidebar and three footer widget areas using block widgets. - Static-front-page, posts-page, privacy-page, and sticky-story assignments. Stable `_globalnews_demo_id` markers prevent uncontrolled duplicate records. Running the importer again reuses existing demo records and does not overwrite edited page or post body content. A demo record moved to Trash is restored on rerun. ## Editing the homepage Open **Pages → Home → Edit**. The imported homepage contains individually selectable blocks; it is not a Custom HTML block or a hardcoded PHP page. The source design’s record-driven sections use four focused server-rendered Gutenberg blocks: - **News Spotlight** — lead-story slider with category, story count, excerpt, autoplay, and interval controls. - **Category Story Feed** — category query with lead/list, grid, compact, and horizontal-carousel layouts. - **Newsletter Signup** — editable copy plus a secure `wp_mail()` submission workflow. - **Contact Form** — editable copy plus validated, nonce-protected contact delivery. Core headings, paragraphs, columns, images, galleries, lists, quotes, Details/FAQ items, and buttons remain normal core blocks. Additional homepage and section compositions are available under **Patterns → Globalnews Magazine**. ## Posts and editorial metadata Use standard WordPress Posts, Categories, Tags, Authors, featured images, excerpts, revisions, comments, and archives. The post editor includes an **Editorial details** panel for: - Kicker / eyebrow text. - Optional 0–5 editorial rating in 0.5 increments. No custom post type or custom taxonomy is needed for this source site. Article collections remain dynamic and category-driven. ## Menus and footer Manage menus under **Appearance → Menus**: - Primary Navigation - Utility Navigation - Footer Navigation - Social Links Manage the news sidebar and footer columns under **Appearance → Widgets**. Footer branding follows the WordPress custom logo and site title. Copyright text is editable under **Appearance → Customize → Footer Options**. ## Global design controls `theme.json` supplies the editor palette, typography presets, spacing scale, content widths, borders, shadows, and button defaults. Use the block editor’s Styles controls for page/block presentation. Theme-chrome controls are under **Appearance → Customize**: - Accessible accent and navigation colors. - Wide-container width. - Button corner radius. - Utility bar and breaking-news strip. - Header and sidebar advertisement visibility, images, and links. - Footer copyright text. - WordPress custom logo, site title, tagline, background, and Site Icon controls. ## Templates Included templates cover the front page, posts index, standard page, single article, generic archives, categories, tags, dates, authors, search results, attachments, comments, 404, and a dynamic Masonry News page template. Search-found and search-empty states are generated from the same WordPress search route rather than separate static pages. ## Forms and email The Newsletter Signup and Contact Form blocks: - Post to WordPress `admin-post.php` handlers. - Verify nonces. - Sanitize and validate submitted fields. - Use honeypots and brief privacy-conscious IP-hash rate limits. - Send through `wp_mail()` to the WordPress administration email. - Store no subscriber or contact-message database table in the theme. A production site must have working WordPress mail delivery, commonly through an authenticated SMTP or transactional-email plugin. Update the imported Privacy Policy when adding analytics, advertising, CRM, or external form services. ## Accessibility and responsive behavior The theme uses semantic landmarks, a skip link, visible focus states, keyboard-operated menus, labeled forms, accessible controls, minimum touch targets, overflow-safe tables and code blocks, reduced-motion handling, pause/resume controls for rotating content, and native dialog behavior for gallery images where supported. Layouts are mobile-first and use flexible Grid/Flexbox, `minmax()`, `clamp()`, logical properties, fluid gutters, and bounded content containers. The principal breakpoints are 36rem, 48rem, 64rem, and 75rem, with fluid behavior between them. ## SEO and plugin compatibility The theme uses WordPress document titles, semantic headings, clean pagination, native author/category/tag/date routes, NewsArticle microdata, and normal image-alt handling. It does not implement a competing SEO system and is designed to coexist with Yoast SEO, Rank Math, SEOPress, All in One SEO, and similar plugins. ## Dependencies No required plugin is bundled. The theme does **not** require ACF, ACF Pro, WooCommerce, Elementor, Divi, WPBakery, or another page builder. No proprietary package is redistributed. ## Asset and licensing notes Theme PHP, JavaScript, CSS, generated logo/icon artwork, and generated screenshot are licensed under GPL-2.0-or-later. Demo photographs and advertisement graphics were supplied in the source project archive; the site owner must retain or verify the rights needed for production use and redistribution. No source font files are redistributed by this theme. ## Validation scope The packaged copy is checked for PHP and JavaScript syntax, JSON and `theme.json` validity, block metadata, required templates, direct-access guards, duplicate function declarations, text-domain consistency, asset references, Gutenberg block serialization, prohibited giant Custom HTML blocks, ZIP integrity, and one-root-directory packaging. A full WordPress activation/import/browser run still depends on a WordPress installation, database, and web server.