=== Alan WP Theme ===
Contributors: wptemplates
Tags: news, blog, entertainment, two-columns, right-sidebar, custom-colors, custom-logo, custom-menu, featured-images, footer-widgets, sticky-post, theme-options, threaded-comments, translation-ready
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A bold, creative news and magazine theme.

== Description ==

Alan is a free news and magazine theme with an editorial look: a big serif masthead, a mosaic hero,
a breaking-news ticker and colour-coded sections.

Features:

* Mosaic or split hero, "Editor's Picks" strip and three configurable category blocks
  (feature + list, grid of four, dark overlay cards)
* Breaking-news ticker (source category, label, number of headlines, speed)
* Light and dark colour schemes, with an optional visitor switch that remembers the choice
* Per-category badge colours (Posts > Categories > edit a category)
* Reading time, built-in view counter (with a "Views" column in the Posts list) and reading progress bar
* Share buttons (sticky rail on desktop), author box, related posts, previous/next links
* Seven widgets: Posts (latest / most viewed / most commented / random, four styles), Tabbed Posts,
  Categories, Social Profiles, About / Author, Newsletter (works with MC4WP) and Ad Banner
* Eight widget areas: main sidebar, below hero, header banner, after post, four footer columns
* Block styles (pull quote, kicker, callout, drop cap) and patterns (key facts, pull quote, live update)
* theme.json palette and type scale, editor styles, Magazine Home and Full Width page templates
* Search overlay, sticky navigation, mobile drawer menu, back-to-top button
* Yoast SEO breadcrumbs on single posts when Yoast is active; styled Contact Form 7 forms
* Appearance > Alan Theme: getting-started screen with one-click install of recommended plugins
* One Click Demo Import support (demo posts, menus, widgets and settings)

== Installation ==

1. Appearance > Themes > Add New > Upload Theme, choose alan-wp-theme.zip, then Activate.
2. Open Appearance > Alan Theme and install the recommended plugins.
3. Optional: Appearance > Import Demo Data to load the demo.
4. Customize under Appearance > Customize > Alan Theme Options.

== Frequently Asked Questions ==

= How do I make a story appear in the hero? =
Put it in the category chosen under Customize > Alan Theme Options > Front Page Layout > Hero mosaic category
(the demo uses "Featured"). The badge then shows the story's other category.

= How do I set a category's colour? =
Posts > Categories > edit the category > Badge colour.

= The newsletter widget does nothing =
Install MC4WP: Mailchimp for WordPress, create a form, and enter its ID in the widget, or enter your
mailing provider's form action URL.

== Changelog ==

= 1.0.0 =
* Initial release.

== Copyright ==

Alan WP Theme, Copyright 2026 WP Templates (https://wptemplates.badran.tech/)
Alan WP Theme is distributed under the terms of the GNU GPL v2 or later.

This program is free software: you can redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software Foundation, either version 2 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

== Resources ==

* Fraunces font, Copyright The Fraunces Project Authors, SIL Open Font License 1.1, loaded from Google Fonts
* Inter font, Copyright The Inter Project Authors, SIL Open Font License 1.1, loaded from Google Fonts
* Icons: inline SVGs drawn for this theme, GPLv2 or later
* Screenshot and demo photos: Lorem Picsum (https://picsum.photos), originals from Unsplash, Unsplash License
