# 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.
