=== KopaNews ===
Contributors: RastryDesign
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: news, entertainment, grid-layout, two-columns, three-columns, right-sidebar, custom-background, custom-colors, custom-header, custom-logo, custom-menu, editor-style, featured-image-header, featured-images, theme-options, translation-ready

KopaNews is a powerful, modern, and professional news and magazine WordPress theme with pixel-perfect design and outstanding functionality. KopaNews features native WordPress Core Starter Content for instant live setup in the Customizer, clean code, news ticker, sticky menu, logo upload, header image, custom background, and Bootstrap 5 framework, built with SEO and accessibility in mind, mobile ready, translation ready (WPML, Polylang), and beautiful on all screen sizes. Perfectly suited for news agencies, digital newspapers, editorial portals, online magazines, broadcast media, world news, politics, business, finance, sports, technology, entertainment, travel, and personal blogs. Includes visual wireframe layout pickers, theme color presets, breaking news ticker, and compatibility with popular plugins like Yoast SEO, Rank Math, Contact Form 7, and Jetpack.

== Description ==

KopaNews is a powerful, modern, and professional news and magazine WordPress theme with pixel-perfect design and outstanding functionality. KopaNews features native WordPress Core Starter Content for instant live setup in the Customizer, clean code, news ticker, sticky menu, search modal, logo upload, header image, custom background, and the Bootstrap 5 framework, designed with SEO and web accessibility in mind, besides being mobile ready, translation ready (WPML, Polylang compatible), and built to be beautiful on all screen sizes.

The theme is perfectly suited for news agencies, digital newspapers, editorial portals, online magazines, broadcast media, world news, politics, business, finance, sports, technology, entertainment, fashion, travel, science, investigative journalism, lifestyle, and personal blogs.

KopaNews provides pure CSS visual wireframe layout pickers, dynamic theme color presets with hover tints, and an animated live breaking news ticker bar. It supports popular WordPress plugins such as Yoast SEO, Rank Math, Contact Form 7, Jetpack, Google Analytics, and caching plugins, while functioning completely out of the box with zero external dependencies.

= Built-in Starter Content =
KopaNews integrates seamlessly with WordPress Core's Starter Content API:
* Automatic starter page creation (Home, News & Articles, About Us, Contact)
* Pre-configured reading settings and front-page layout
* Pre-configured primary and footer navigation menus
* Sidebar and footer starter widgets
* 100% compliant with WordPress core conventions and Theme Review Team standards: zero third-party plugin requirements, zero admin clutter, and zero destructive actions.

= Core Features =
* Modern news and magazine theme design
* Built-in starter content integration
* Live breaking news ticker bar
* Translation ready with 24 pre-bundled language packs (.po and .mo files) and WPML/Polylang compatibility
* Category wireframe grid layouts (Hero grid, Featured left, 4-column grid, 3-column grid, Media row)
* Fully dynamic category sections (1 to 15) configurable via the WordPress Customizer
* Complete support for static front page and blog posts index according to standard WordPress template hierarchy
* Global 1440px centered layout for optimal readability on all screen sizes
* Fully responsive and touch-friendly on mobile, tablet, and desktop
* Customizer integration for logo, site icon, theme colors, wireframe layouts, and section styling
* Accessibility ready with keyboard navigation, visible focus indicators, search dialog focus trap, and skip link
* 100% GPL compliant with locally bundled scripts/styles and typography enqueued via Google Fonts (fonts.googleapis.com)

== Installation ==

1. In your WordPress admin dashboard, navigate to Appearance > Themes.
2. Click "Add New" and then "Upload Theme".
3. Choose the `kopanews.zip` file and click "Install Now".
4. Click "Activate" to make KopaNews your active theme.
5. On a fresh installation, open Appearance > Customize to preview and publish the pre-populated starter content and customize your category layouts, colors, and logo.
6. Alternatively, configure manually:
   - Create two pages in Pages > Add New: "Home" and "Blog".
   - Navigate to Settings > Reading.
   - Under "Your homepage displays", choose "A static page".
   - Set "Homepage" to "Home" and "Posts page" to "Blog", then save changes.
   - Visit Appearance > Customize to configure category sections, colors, and layout options.

== Frequently Asked Questions ==

= Does KopaNews include built-in starter content? =
Yes. KopaNews implements the official WordPress Core Starter Content API (`add_theme_support( 'starter-content' )`). On a fresh WordPress installation (`fresh_site`), open the Customizer (Appearance > Customize) to preview the pre-populated news portal layout (sample news stories, verified CC0 featured images, starter pages, navigation menus, reading settings, and widgets), and click "Publish" to save them without deleting or modifying any existing user content.

= How does KopaNews comply with WordPress guidelines for Static Front Page and Blog Posts Index? =
KopaNews strictly follows the WordPress Theme Review Team requirements detailed by Chip Bennett ("Correct Handling of Static Front Page and Custom Blog Posts Index Template"):
1. When Settings > Reading is configured to "Your latest posts": front-page.php detects this configuration and directly includes get_home_template(), displaying the standard blog posts index cleanly instead of forcing a static magazine front page.
2. When Settings > Reading is configured to "A static page":
   - The designated Front page uses front-page.php to render the dynamic magazine portal with Customizer-controlled wireframe sections.
   - The designated Posts page automatically uses home.php to render the blog posts index with full pagination, sidebars, and standard loop compatibility.
3. Strict template hierarchy compliance: KopaNews does not use prohibited workarounds such as template-blog.php, page-blog.php, or template_include filters to hijack the blog posts index.

= How do I configure the homepage and blog posts index manually? =
If you prefer to configure manually:
1. Create two pages in Pages > Add New: one titled "Home" and one titled "Blog".
2. Navigate to Settings > Reading in your WordPress admin dashboard.
3. Under "Your homepage displays", select "A static page".
4. Set "Homepage" to your "Home" page, and "Posts page" to your "Blog" page.
5. Click "Save Changes". Your front page will display the full dynamic magazine layout (front-page.php), and your Blog page will display the blog posts index (home.php).

= Is KopaNews accessible? =
Yes, KopaNews includes skip links pointing directly to the #primary content container, visible keyboard focus highlights, accessible search forms with focus traps, and ARIA attributes compliant with WordPress accessibility guidelines.

== License & Copyright ==

KopaNews WordPress Theme, Copyright 2026 RastryDesign
KopaNews is distributed under the terms of the GNU General Public License v2 or later.

This theme bundles the following third-party resources:

* Bootstrap Framework v5.3.3
  Source: https://getbootstrap.com/
  License: MIT License

* Bootstrap Icons v1.11.3
  Source: https://icons.getbootstrap.com/
  License: MIT License

* Inter Font & Roboto Condensed Font
  Source: https://fonts.google.com/
  License: SIL Open Font License, 1.1
  Note: Enqueued remotely via Google Fonts API (https://fonts.googleapis.com) in accordance with the permitted exception in the WordPress.org theme review guidelines.

* Theme Brand Graphics (`assets/images/logo.png`, `assets/images/site-icon.png`)
  Source: Original artwork created by RastryDesign.
  License: GNU General Public License v2 or later.

* Theme Screenshot (`screenshot.png`) & Bundled Starter Content Images (`assets/demo-data/images/`)
  Source: PxHere (https://pxhere.com/)
  License: Creative Commons Zero (CC0) 1.0 Universal Public Domain Dedication (https://creativecommons.org/publicdomain/zero/1.0/)
  License Proof: https://pxhere.com/en/license (All photos on PxHere are released under CC0 Public Domain, free for commercial use and modification)
  Complete list of all 35 bundled starter content images (including the 13 images visible in `screenshot.png`):
  - `assets/demo-data/images/pxhere-194.jpg`: https://pxhere.com/en/photo/194 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-287.jpg`: https://pxhere.com/en/photo/287 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-785.jpg`: https://pxhere.com/en/photo/785 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-99190.jpg`: https://pxhere.com/en/photo/99190 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-104355.jpg`: https://pxhere.com/en/photo/104355 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-113640.jpg`: https://pxhere.com/en/photo/113640 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-284239.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/284239 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-483575.jpg`: https://pxhere.com/en/photo/483575 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-583378.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/583378 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-593359.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/593359 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-597908.jpg`: https://pxhere.com/en/photo/597908 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-616075.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/616075 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-744301.jpg`: https://pxhere.com/en/photo/744301 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-764684.jpg`: https://pxhere.com/en/photo/764684 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-813723.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/813723 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-838852.jpg`: https://pxhere.com/en/photo/838852 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-868620.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/868620 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-883393.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/883393 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-894428.jpg`: https://pxhere.com/en/photo/894428 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-894496.jpg`: https://pxhere.com/en/photo/894496 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-917215.jpg`: https://pxhere.com/en/photo/917215 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-970908.jpg`: https://pxhere.com/en/photo/970908 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-971394.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/971394 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1026043.jpg`: https://pxhere.com/en/photo/1026043 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1134114.jpg`: https://pxhere.com/en/photo/1134114 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1153979.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/1153979 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1273609.jpg`: https://pxhere.com/en/photo/1273609 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1322766.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/1322766 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1338927.jpg`: https://pxhere.com/en/photo/1338927 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1351190.jpg`: https://pxhere.com/en/photo/1351190 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1356678.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/1356678 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1373307.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/1373307 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1435009.jpg` (also in `screenshot.png`): https://pxhere.com/en/photo/1435009 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1634404.jpg`: https://pxhere.com/en/photo/1634404 (CC0 1.0 Universal)
  - `assets/demo-data/images/pxhere-1679886.jpg`: https://pxhere.com/en/photo/1679886 (CC0 1.0 Universal)

== Changelog ==

= 1.0.4 =
* Added: Included original, unminified source files for Bootstrap CSS, Bootstrap Icons CSS, and Bootstrap JS bundle alongside their minified versions (with SCRIPT_DEBUG support) per WordPress Theme Review requirements.
* Added: Built-in translation files (.po and .mo) for 24 languages: German (de_DE), Spanish (es_ES), French (fr_FR), Italian (it_IT), Dutch (nl_NL), Swedish (sv_SE), Brazilian Portuguese (pt_BR), Portugal Portuguese (pt_PT), Russian (ru_RU), Chinese Simplified (zh_CN), Japanese (ja), Hindi (hi_IN), Bengali (bn_BD), Danish (da_DK), Norwegian Bokmål (nb_NO), Finnish (fi), Polish (pl_PL), Czech (cs_CZ), Turkish (tr_TR), Korean (ko_KR), Thai (th), Indonesian (id_ID), Malay (ms_MY), and Filipino (fil).
* Updated: Streamlined theme descriptions in style.css and readme.txt.

= 1.0.3 =
* Fixed: Added active_callback to the starter content Customizer section so it only displays on fresh sites, keeping it consistent with the Customizer notification.
* Fixed: Replaced custom demo card control and duplicate onclick Publish button with native core Customizer section description UI.
* Fixed: Removed emoji from translatable section title string for clean internationalization.
* Fixed: Removed hardcoded section background fallback so all homepage sections seamlessly inherit custom-background color settings.

= 1.0.2 =
* Fixed: Replaced all bundled and screenshot images with Creative Commons CC0 1.0 Universal images from PxHere (https://pxhere.com/), completely removing all Pexels-licensed resources for 100% GPL compatibility.
* Fixed: Removed custom demo installer, admin menu page (Appearance > KopaNews Demo Setup), and admin notice onboarding flow to comply with WordPress.org Theme Review guidelines.
* Added: Integrated WordPress Core Starter Content API for native, non-destructive initial layout and Customizer previews on fresh installs.
* Fixed: Removed destructive post, attachment, and menu deletion functions to protect existing user content.
* Fixed: Removed 'full-width-template' tag from style.css and readme.txt.
* Fixed: Prefixed helper function require_get_template_directory() to kopanews_require_template_file().
* Updated: Corrected readme.txt external font wording to accurately reflect Google Fonts enqueue (permitted exception).
* Updated: Streamlined theme description and documentation for WordPress.org theme repository compliance.

= 1.0.1 =
* Added: Fully dynamic category sections, driven completely by Customizer / options settings (kopanews_get_section_config()) without hardcoded category slugs.
* Added: Customizer controls for total homepage sections count (kopanews_num_sections from 1 to 15), custom section accent colors, and background styling.
* Added: Dedicated blog posts index template (home.php) supporting standard pagination, post meta, author info, and sidebar widgets.
* Added: Global 1440px max-width layout container with automatic centering for ultrawide screen optimization.
* Fixed: Removed non-standard tags (magazine, one-click-demo-import) from style.css header.
* Fixed: Added main #primary container to all page templates so the skip-to-content target exists across all views.
* Fixed: Navigation menu multi-level submenu display, split toggle buttons, and keyboard navigation.
* Fixed: Focus trapped inside search modal dialog with proper ARIA attributes.
* Fixed: Updated Tested up to WordPress 7.1 in style.css and readme.txt.
* Added: License details, and source URLs for screenshot images in readme.txt.

= 1.0.0 =
* Initial public release.
