=== ChronoCards Ruchir ===
Contributors: ruchirgoswami
Tags: blog, portfolio, timeline, cards, responsive, one-column, two-columns, grid-layout, custom-colors, custom-logo, custom-menu, editor-style, translation-ready
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.9
License: GPLv2+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A modern storytelling WordPress theme that combines a vertical timeline with card-based layouts. Perfect for blogs, portfolios, and agencies.

== Description ==

ChronoCards Ruchir is a lightweight, modern WordPress theme that combines a vertical timeline layout with stylish card-based post design. Perfect for bloggers, portfolios, and agencies, this theme lets you showcase milestones, projects, or stories in a unique way.

**Key Features:**

* **Timeline Layout**: Posts are displayed in a vertical timeline with milestone dots
* **Card Design**: Each post appears as a modern card with featured images
* **Dynamic Colors**: Background colors change based on categories or featured images
* **Responsive Design**: Mobile-first approach with responsive grid system
* **Customizable**: Extensive customization options through WordPress Customizer
* **Accessibility Ready**: Built with accessibility standards in mind
* **Translation Ready**: Fully prepared for translation
* **SEO Friendly**: Clean, semantic HTML structure
* **Block Editor Support**: Full support for WordPress block editor

**Perfect For:**

* Personal blogs showcasing life journey posts
* Agency portfolios displaying projects as timeline milestones
* Company history pages with achievement cards
* Storytelling websites with chronological content
* Any site that wants to combine timeline and card layouts

**Theme Structure:**

The theme uses a hybrid approach combining:
- Timeline order (chronological storytelling)
- Card look (modern, Pinterest/Trello style)
- Dynamic colors based on categories
- Expandable cards with AJAX functionality
- Responsive flow (two-column desktop, single-column mobile)

== Installation ==

1. Upload the theme files to the `/wp-content/themes/chronocards-ruchir` directory, or install the theme through the WordPress themes screen directly.
2. Activate the theme through the 'Themes' screen in WordPress.
3. Go to Appearance > Customize to configure theme options.

== Frequently Asked Questions ==

= Does this theme support the block editor? =

Yes, ChronoCards Ruchir fully supports the WordPress block editor (Gutenberg) with custom editor styles.

= Is the theme responsive? =

Yes, the theme is built with a mobile-first approach and is fully responsive across all devices.

= Can I customize the colors? =

Yes, you can customize timeline colors, card backgrounds, and category colors through the WordPress Customizer.

= Does the theme support custom menus? =

Yes, the theme supports custom navigation menus through the WordPress menu system.

= Is the theme translation ready? =

Yes, the theme is fully translation ready and includes all necessary text domains.

= Does the theme work with page builders? =

The theme is compatible with most page builders, though it's optimized for the WordPress block editor.

== Screenshots ==

1. Homepage with timeline layout showing cards alternating left and right
2. Single post page with featured image and content
3. Customizer options for timeline and typography settings
4. Mobile responsive view of the timeline

== Changelog ==

= 1.8 =
* Updated screenshot to remove embedded images; screenshot now shows only theme layout rendered via HTML/CSS (no photographic or stock assets)
* Updated screenshot-info.txt to document that no external images are used in the screenshot

= 1.7 =
* Fixed skip link focus visibility - blue outline now appears when clicking "Skip to content" button
* Enhanced skip link JavaScript to properly handle click events and ensure focus styles are applied
* Added detailed documentation for featured images used in screenshot with source URLs and license details
* Improved CSS focus styles for main content area (#primary) when targeted by skip link

= 1.6 =
* Fixed focus indicator visibility for featured images in post list (keyboard navigation)
* Removed credit link from footer (compliance with WordPress.org guidelines)
* Enhanced screenshot image source and license documentation in readme.txt
* Fixed font size sanitization in customizer (proper numeric validation)
* Fixed inline CSS output (removed wp_strip_all_tags, proper individual sanitization)
* Updated "Tested up to" WordPress version to 6.9

= 1.5 =
* Fixed JavaScript function prefixing - all functions now properly prefixed with chronocards_ruchir_
* Removed Author URI from style.css header (optional field)
* Added comprehensive image links documentation to README file
* Enhanced keyboard navigation for mobile media elements
* Improved accessibility for images and media content
* Added block styles registration (timeline-text, timeline-card, featured-image)
* Added block patterns registration (timeline-card, hero-section, two-column-content)
* Registered custom block pattern category for theme patterns

= 1.4 =
* Fixed skip link to work natively without JavaScript dependency
* Added underlined links in content areas (entry-content, comment-content, widget_text) for accessibility compliance
* Enhanced data sanitization in customizer.php with proper fallback values
* Improved skip link JavaScript to only enhance native functionality
* All WordPress.org theme review requirements now fully met

= 1.3 =
* Fixed skip link visibility on focus for keyboard navigation accessibility
* Enhanced mobile menu keyboard navigation with proper focus trapping
* Fixed long title wrapping issues on archive and single pages
* Updated "Tested up to" to WordPress 6.8 (latest version)
* Updated placeholder image service URL from via.placeholder.com to placehold.co
* Enhanced screenshot image licensing documentation
* Verified all text strings are translation-ready in footer.php
* Improved focus management and accessibility throughout the theme

= 1.2 =
* Fixed WordPress.org theme review compliance issues
* Removed WordPress.org Theme URI (reserved for default themes)
* Updated image licensing to use GPL-compatible sources
* Added empty Theme URI field in style.css header
* Improved theme compliance with WordPress.org guidelines

= 1.1 =
* Version update to 1.1

= 1.0 =
* Initial release
* Timeline layout with milestone dots
* Card-based post design
* Dynamic category colors
* Responsive design
* WordPress Customizer integration
* Block editor support
* Accessibility features
* Translation ready

== Upgrade Notice ==

= 1.0 =
Initial release of ChronoCards Ruchir theme.

== Credits ==

This theme was created by Ruchir Goswami and follows WordPress coding standards and best practices.

**Third-Party Resources:**

* **jQuery**: JavaScript library
  - License: MIT License (GPL compatible)
  - Source: https://jquery.org/license/
  - Used for: Theme functionality and interactions
  - Note: Included with WordPress core

* **WordPress Core**: WordPress functionality
  - License: GPL v2 or later
  - Source: https://wordpress.org/about/license/
  - Used for: Core WordPress features and functions

* **System Fonts**: Web-safe fonts
  - License: System fonts (no license required)
  - Used for: Typography (Apple System Font, BlinkMacSystemFont, Segoe UI, Roboto, Oxygen, Ubuntu, Cantarell, sans-serif)
  - Note: These are operating system fonts with no licensing restrictions

* **Placeholder Image Service**: placehold.co
  - License: Free to use (no specific license)
  - Source: https://placehold.co/
  - Used for: Demo content in block patterns only
  - Note: Only used in example block patterns, not in actual theme functionality

**Images Used in Theme:**

* **Theme Screenshot (screenshot.png):**
  - **File**: screenshot.png (1200x900 pixels)
  - **Source URL**: Custom created by theme author (Ruchir Goswami) for this theme
  - **License**: GNU General Public License v2 or later (GPLv2+)
  - **License URL**: https://www.gnu.org/licenses/gpl-2.0.html
  - **Author/Creator**: Ruchir Goswami (theme author)
  - **Description**: The screenshot displays the theme's timeline layout with card-based post design.

* **Featured Images Used in Screenshot:**

  **Image 1 - Technology/Code Featured Image:**
  - **Source URL**: Custom created by theme author (Ruchir Goswami) for this theme
  - **License**: GNU General Public License v2 or later (GPLv2+)
  - **License URL**: https://www.gnu.org/licenses/gpl-2.0.html
  - **Author/Creator**: Ruchir Goswami (theme author)
  - **Description**: Featured image displayed in the first timeline card in the screenshot, representing technology/code category. Custom created placeholder image.

  **Image 2 - Business/Office Featured Image:**
  - **Source URL**: Custom created by theme author (Ruchir Goswami) for this theme
  - **License**: GNU General Public License v2 or later (GPLv2+)
  - **License URL**: https://www.gnu.org/licenses/gpl-2.0.html
  - **Author/Creator**: Ruchir Goswami (theme author)
  - **Description**: Featured image displayed in the second timeline card in the screenshot, representing business/office category. Custom created placeholder image.

  **Note**: All featured images shown in the screenshot are custom created by the theme author (Ruchir Goswami) specifically for this theme. No third-party images, stock photos, or external image sources are used. All images are original work by the theme author and licensed under GPLv2+.

* **Featured Images in Posts:**
  - The theme displays featured images uploaded by users through WordPress media library
  - Images are displayed using WordPress core function `get_the_post_thumbnail()`
  - No default images are bundled with the theme
  - Users are responsible for ensuring their uploaded images comply with applicable licenses

* **Custom Logo:**
  - Theme supports custom logo through WordPress Customizer
  - Logo images are uploaded by users, not bundled with the theme

Special thanks to:
- WordPress community for inspiration and guidelines
- Theme reviewers for feedback and suggestions
- Beta testers for their valuable input

== Support ==

For support, feature requests, or bug reports, please visit the theme's support forum on WordPress.org or contact the theme author.

== License ==

ChronoCards Ruchir WordPress Theme, Copyright 2025 Ruchir Goswami
ChronoCards Ruchir is distributed under the terms of the GNU GPL

This theme is distributed under the GNU General Public License v2 or later.  
License URI: https://www.gnu.org/licenses/gpl-2.0.html

== Privacy Policy ==

This theme does not collect any personal data or user information. It only uses standard WordPress functionality and does not include any tracking or analytics code.
