=== Thirteenmag ===
Contributors: arifhassan
Tags: blog, news, magazine, one-column, two-columns, right-sidebar, custom-background, custom-header, custom-logo, custom-menu, featured-images, full-width-template, threaded-comments, translation-ready, accessibility-ready, block-styles, wide-blocks, editor-style, sticky-post, responsive-layout
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 3.0.0
License: GNU General Public License v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A modern, fast, and accessible WordPress blog and magazine theme built for publishers, bloggers, and content creators.


== Description ==

Thirteenmag is a modern, fast, and accessible WordPress blog and magazine theme built for publishers, bloggers, news sites, and content creators.

Designed with clean typography, responsive layouts, dark mode support, Gutenberg compatibility, SEO-friendly structure, and performance-focused code for an excellent reader experience on all devices.

= Key Features =

* Light and Dark mode toggle with localStorage persistence and OS preference detection
* Responsive layout — mobile first, works on all screen sizes
* Breaking news ticker bar with smooth scrolling animation
* Multiple homepage layouts — 3-column grid, 2-column grid, and list view
* Featured hero post card on homepage
* Sticky header with hide-on-scroll-down and reveal-on-scroll-up behaviour
* Reading progress bar on single posts
* Sidebar tabs — Recent, Popular, and Comments
* Author bio box on single posts
* Post navigation (previous / next)
* Social share buttons — Twitter/X, Facebook, LinkedIn, Copy Link
* Newsletter block after single posts — supports any embed code (Mailchimp, ConvertKit, Brevo, MailerLite, Jotform, and more) or built-in form
* Schema.org structured data for articles
* Open Graph and Twitter Card meta tags
* Breadcrumb navigation with Schema.org markup
* Back to top button
* Scroll fade-in animations
* Accessible — keyboard navigable, ARIA labels, skip link, screen reader text
* Gutenberg block editor compatible with wide and full alignment support
* Custom logo, custom header image, custom background
* Translation ready with full .pot file
* No jQuery — pure vanilla JavaScript
* Self-hosted fonts — Inter, Playfair Display, JetBrains Mono


== Installation ==

1. In your admin panel, go to Appearance → Themes and click Add New.
2. Click Upload Theme and choose the theme ZIP file. Click Install Now.
3. Click Activate to use your new theme.

Alternatively, search for "Thirteenmag" in the theme search and install directly.

After activation:
* Go to Appearance → Customize → Theme Options to configure colors, social links, layout, typography, footer, and newsletter.
* Go to Appearance → Menus to assign your Primary Menu and Footer Menu.
* Go to Appearance → Widgets to add widgets to the Main Sidebar and Footer columns.


== Frequently Asked Questions ==

= How do I enable dark mode? =
Click the moon icon in the header. The preference is saved automatically and also follows your OS setting by default.

= How do I set up the newsletter block? =
Go to Appearance → Customize → Theme Options → Newsletter. Choose your provider:
* Embed Code — paste the HTML form code from Mailchimp, ConvertKit, Brevo, MailerLite, Jotform, or any provider.
* Built-in — stores email addresses in WordPress. Export as CSV from Appearance → Newsletter Subscribers.

= How do I change the homepage layout? =
Go to Appearance → Customize → Theme Options → Layout → Homepage Post Layout. Choose between 3-Column Grid, 2-Column Grid, or List View.

= Does this theme support the block editor (Gutenberg)? =
Yes. The theme supports wide and full alignment blocks, block styles, responsive embeds, and includes a matching editor stylesheet.

= Is this theme translation ready? =
Yes. All strings are wrapped in translation functions and a .pot file is included in the languages folder.

= Where do I add my social media links? =
Go to Appearance → Customize → Theme Options → Social Links.

= How do I change the accent color? =
Go to Appearance → Customize → Theme Options → Colors → Accent / Brand Color.


== Changelog ==

= 3.0.0 =
* Complete redesign with modern layout system
* Added dark mode with localStorage persistence and OS preference detection
* Added breaking news ticker bar with scrolling animation
* Added multiple homepage layout options
* Added featured hero card
* Added reading progress bar
* Added sidebar tabs (Recent, Popular, Comments)
* Added author bio box
* Added social share buttons with copy link
* Added newsletter block with embed and built-in provider support
* Added Schema.org structured data
* Added Open Graph and Twitter Card meta tags
* Added breadcrumb navigation
* Added back to top button with smooth animation
* Added scroll fade-in animations using IntersectionObserver
* Replaced jQuery with vanilla JavaScript
* Self-hosted Inter, Playfair Display, and JetBrains Mono fonts
* Added Tailwind CSS utility classes for layout
* Gutenberg block editor support with editor styles
* Improved accessibility — ARIA labels, skip link, keyboard navigation
* Refactored codebase into modular inc/ files
* Added Customizer options for colors, typography, layout, social, footer, newsletter
* Added newsletter subscribers admin page with CSV export
* Removed all external font dependencies

= 2.0.0 =
* Updated theme styles
* Fixed responsive issues
* Fixed archive files
* Various bug fixes

= 1.7.4 =
* Updated footer info

= 1.7.3 =
* Added latest version of Bootstrap

= 1.7.2 =
* Fixed minification of scripts and files

= 1.7.1 =
* Fixed script and header issue

= 1.7.0 =
* Removed SMOF framework

= 1.6.0 =
* Fixed author name in footer

= 1.5.0 =
* Fixed functions theme slug

= 1.4.0 =
* Fixed images with copyright and license information

= 1.3.0 =
* Added changelog and image credits

= 1.2.0 =
* Fixed various issues

= 1.1.0 =
* Resolved Theme Check warnings and required notices

= 1.0.0 =
* Initial release


== Credits ==

= Fonts =

Inter
* Source: https://fonts.google.com/specimen/Inter
* Author: Rasmus Andersson
* License: SIL Open Font License 1.1
* License URI: https://scripts.sil.org/OFL

Playfair Display
* Source: https://fonts.google.com/specimen/Playfair+Display
* Author: Claus Eggers Sørensen
* License: SIL Open Font License 1.1
* License URI: https://scripts.sil.org/OFL

JetBrains Mono
* Source: https://fonts.google.com/specimen/JetBrains+Mono
* Author: JetBrains
* License: SIL Open Font License 1.1
* License URI: https://scripts.sil.org/OFL

= Libraries and Tools =

Tailwind CSS
* Source: https://tailwindcss.com
* License: MIT License
* License URI: https://github.com/tailwindlabs/tailwindcss/blob/master/LICENSE

= Images =

Screenshot image
* Created by Arif Hassan
* License: GNU General Public License v2 or later

= Icons =

All SVG icons used in this theme are inline SVGs drawn from the Lucide icon set.
* Source: https://lucide.dev
* License: ISC License
* License URI: https://github.com/lucide-icons/lucide/blob/main/LICENSE

= Code References =

normalize.css
* Source: https://necolas.github.io/normalize.css/
* License: MIT License
* License URI: https://github.com/necolas/normalize.css/blob/master/LICENSE.md

Underscores (_s) starter theme concepts
* Source: https://underscores.me
* Author: Automattic
* License: GNU General Public License v2 or later
* License URI: https://www.gnu.org/licenses/gpl-2.0.html


== Resources ==

This theme bundles the following third-party resources:

1. Inter font — SIL Open Font License 1.1 — https://fonts.google.com/specimen/Inter
2. Playfair Display font — SIL Open Font License 1.1 — https://fonts.google.com/specimen/Playfair+Display
3. JetBrains Mono font — SIL Open Font License 1.1 — https://fonts.google.com/specimen/JetBrains+Mono
4. Tailwind CSS — MIT License — https://tailwindcss.com
5. Lucide Icons — ISC License — https://lucide.dev