=== Crowdfunding Platform ===
Contributors: ignitionwp
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 0.13.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: blog, one-column, two-columns, custom-colors, custom-logo, custom-menu, editor-style, featured-images, full-site-editing, block-patterns, rtl-language-support, sticky-post, threaded-comments, translation-ready, wide-blocks

A clean and minimal WordPress block theme designed specifically for crowdfunding websites.

== Description ==

Crowdfunding Platform is a modern, accessible WordPress block theme built specifically for creators, entrepreneurs, and organizations running crowdfunding campaigns. Whether you're launching a product, funding a creative project, or supporting a cause, this theme provides the essential tools you need while maintaining simplicity for non-technical users.

**Key Features:**

* **Full Site Editing (FSE)** - Complete control over your site design using the WordPress block editor
* **WCAG 2.1 AA Compliant** - Meets accessibility standards with keyboard navigation and screen reader support
* **Responsive Design** - Mobile-first approach that looks great on all devices
* **26+ Custom Block Patterns** - Pre-designed layouts for campaigns, hero sections, rewards, and starter content
* **Plugin Compatible** - Works with any crowdfunding plugin (IgnitionDeck, WP Crowdfunding, etc.)
* **5 Style Variations** - Multiple color schemes including minimal clean designs
* **Performance Optimized** - Lightweight with minimal dependencies
* **Translation Ready** - Fully internationalized for global campaigns

**Perfect For:**
- Crowdfunding campaigns
- Product launches  
- Creative projects
- Non-profit fundraising
- Business startups
- Community initiatives

**Block Patterns Included:**
- Campaign hero with progress bars (standard and flipped layouts)
- Campaign grid layouts and masonry displays
- Campaign rewards display (vertical and horizontal layouts)
- Campaign sections and tabs interface
- Homepage hero sections and starter content
- Reward cards (standard, featured, custom, and vertical variants)
- Blog post cards and metadata patterns
- Comments and post footer patterns
- Complete starter content for quick campaign setup

The theme follows WordPress.org coding standards and has been built using Twenty Twenty-Five as a reference for best practices and accessibility compliance.

== Installation ==

1. Download the theme ZIP file
2. Log in to your WordPress admin dashboard
3. Navigate to Appearance > Themes
4. Click "Add New" then "Upload Theme"
5. Choose the downloaded ZIP file and click "Install Now"
6. Click "Activate" to enable the theme
7. Go to Appearance > Site Editor to customize your site

== Getting Started ==

1. **Set up your homepage**: Go to Appearance > Site Editor and select "Pages" to edit your homepage template
2. **Add block patterns**: Use the pattern browser (+) to insert pre-designed campaign layouts
3. **Customize colors**: Access Appearance > Site Editor > Styles to choose from 5 color variations
4. **Configure navigation**: Edit your header template to update menu links for your campaigns
5. **Install a crowdfunding plugin**: Add your preferred crowdfunding functionality

== Block Editor Support ==

This theme is built specifically for the WordPress block editor and Full Site Editing. It includes:

- 26+ custom block patterns with progress bar theming
- 5 style variations for different looks and branding
- Template parts for headers and footers
- Custom templates for pages, posts, archives, and 404 errors
- Wide and full-width block alignment support
- Responsive spacing using clamp() functions

== Accessibility ==

Crowdfunding Platform meets WCAG 2.1 AA accessibility standards:

- Proper color contrast ratios (4.5:1 for normal text)
- Keyboard navigation support with visible focus indicators
- Screen reader compatibility with proper ARIA labels
- Semantic HTML5 structure throughout
- Skip links for easier navigation (auto-generated by WordPress)
- Accessible form labels and button interactions
- Focus styles that don't interfere with design

== Browser Support ==

- Chrome (latest)
- Firefox (latest) 
- Safari (latest)
- Edge (latest)

== Frequently Asked Questions ==

= Does this work with crowdfunding plugins? =

Yes! This theme is designed to be compatible with any crowdfunding plugin including IgnitionDeck, WP Crowdfunding, Charitable, and others. The theme provides the design foundation while your chosen plugin handles the crowdfunding functionality.

= Can I customize the colors and fonts? =

Absolutely! The theme includes 5 style variations and you can customize colors, fonts, and layouts using the WordPress Site Editor (Appearance > Site Editor > Styles).

= Is this theme accessible? =

Yes, the theme meets WCAG 2.1 AA accessibility standards with proper keyboard navigation, screen reader support, and color contrast compliance.

= Does it work on mobile devices? =

Yes, the theme uses a mobile-first responsive design that adapts to all screen sizes and devices.

= Can I translate this theme? =

Yes, the theme is translation-ready and includes all necessary internationalization functions for multilingual sites.

= How do I update my patterns after customization? =

When patterns are updated for accessibility or other improvements, you'll need to remove and re-add them to existing pages due to WordPress pattern caching.

= Can I customize the progress bar colors? =

Yes! Progress bars automatically adapt to your chosen style variation. Advanced users can customize progress bar colors using CSS custom properties - see the Advanced Customization section below.

= Does this theme support child themes? =

Yes, the theme is fully compatible with child themes. All functions are properly wrapped with function_exists() checks and use appropriate WordPress functions for child theme inheritance. See the Child Theme Support section below for details.

== Advanced Customization ==

**For Developers and Advanced Users:**

**Progress Bar Styling:**
The theme includes CSS custom properties for progress bar customization:

```css
/* Override in your child theme or custom CSS */
:root {
  --wp--custom--progress-bar--background: #f0f0f0;
  --wp--custom--progress-bar--fill: #0073aa;
  --wp--custom--progress-bar--border-color: #ddd;
  --wp--custom--progress-bar--border-radius: 0.5rem;
  --wp--custom--progress-bar--height: 2rem;
}
```

Progress bars automatically adapt to style variations, but these custom properties allow fine-grained control.

**Theme.json Integration:**
The theme uses WordPress theme.json custom settings for consistent theming. Progress bar colors are defined in `settings.custom.progressBar` and generate CSS custom properties automatically.

**Plugin Pattern Registration API:**
Crowdfunding plugins can register custom patterns that match the theme's design:

```php
add_filter( 'crowdfunding_platform_register_patterns', function( $patterns ) {
    $patterns[] = array(
        'slug'        => 'my-plugin/campaign-card',
        'title'       => 'Campaign Card',
        'content'     => '<!-- wp:group -->...',
        'categories'  => array( 'crowdfunding_platform' )
    );
    return $patterns;
});
```

The theme automatically validates patterns and ensures design consistency. Plugin developers can use theme CSS classes (`.pattern-campaign-card`, `.theme-progress-bar`, `.pattern-reward-card`) and color variables (`--wp--preset--color--primary`, `--wp--preset--color--accent`).

== Child Theme Support ==

**Full Child Theme Compatibility:**

The Crowdfunding Platform is designed with complete child theme support. All functions use `function_exists()` checks and proper WordPress functions for seamless child theme inheritance.

**Child Theme Setup:**

1. Create a new directory in `wp-content/themes/` (e.g., `crowdfunding-child/`)
2. Create `style.css` with proper header:

```css
/*
Theme Name: Your Child Theme Name
Template: crowdfunding-platform
Version: 1.0.0
*/

/* Your customizations here */
```

3. Create `functions.php` to add custom functionality (optional)

**What You Can Override:**

* **Templates**: All FSE templates (page.html, single.html, etc.)
* **Template Parts**: Header, footer, and other template parts
* **Patterns**: Override existing patterns or add new ones
* **Styles**: Customize colors, fonts, spacing via CSS
* **Functions**: All theme functions can be safely overridden

**Overrideable Functions:**

* `crowdfunding_platform_setup()` - Theme initialization and features
* `crowdfunding_platform_scripts()` - Enqueue styles and scripts  
* `crowdfunding_platform_pattern_categories()` - Register pattern categories
* `crowdfunding_platform_register_block_styles()` - Add custom block styles
* `crowdfunding_platform_validate_pattern()` - Pattern validation rules

**Child Theme Best Practices:**

```php
// Always wrap function overrides
if ( ! function_exists( 'crowdfunding_platform_setup' ) ) :
function crowdfunding_platform_setup() {
    // Your custom setup code
}
endif;

// Use the pattern registration API
add_filter( 'crowdfunding_platform_register_patterns', function( $patterns ) {
    $patterns[] = array(
        'slug' => 'child-theme/custom-pattern',
        'title' => 'Custom Pattern',
        'content' => '<!-- wp:paragraph --><p>Content</p><!-- /wp:paragraph -->'
    );
    return $patterns;
});

// WordPress automatically loads child theme's style.css
// Only add this if you need additional CSS/JS files:
function child_theme_scripts() {
    wp_enqueue_style( 'child-additional', 
        get_stylesheet_directory_uri() . '/additional.css',
        array( 'crowdfunding-platform-style' )
    );
}
add_action( 'wp_enqueue_scripts', 'child_theme_scripts', 15 );
```

**Template Inheritance:**

Child themes automatically inherit all parent templates and can override any by creating files with matching names:

* `templates/page.html` - Custom page template
* `parts/header.html` - Custom header
* `patterns/custom-hero.php` - Additional patterns

**Style Customization:**

Use CSS custom properties to modify theme colors and spacing:

```css
:root {
    --wp--preset--color--primary: #your-color;
    --wp--preset--spacing--40: 2rem;
}
```

Child themes work seamlessly with the Site Editor and maintain compatibility with all theme features including style variations, block patterns, and the plugin registration API.

== Changelog ==

= 0.13.5 =
* Fixed keyboard navigation focus indicators being clipped on sticky header and post cards
* Updated screenshot image
* Updated "Tested up to" version to WordPress 6.9
* Removed starter-content-style-guide pattern

= 0.13.4 =
* Update copyright and author information in readme.txt
* Add image source URLs and license details for screenshot
* Make all text strings translation-ready (homepage-hero.php, style-guide, etc.)
* Bundle external images in theme instead of loading from URLs
* Compress screenshot.png to 241KB for WordPress.org compliance

= 0.13.3 =
* Add underlines to body content links for WordPress.org accessibility compliance
* Fix mobile navigation focus indicator visibility
* Fix block validation errors in footer and reward card patterns
* Improve security by escaping apply_filters output in reward patterns
* Move hardcoded text to translatable PHP patterns for internationalization
* Prefix block style names for WordPress.org compliance
* Refactor button CSS to use theme.json variables for consistency

= 0.13.2 =
* Optimize screenshot.png file size to 252KB for WordPress.org requirements
* Remove optional Theme URI header

= 0.13.1 =
* Fix block validation errors for shadow presets
* Fix missing translation function in campaign grid masonry pattern
* Add translator comments for internationalization placeholder strings
* Simplify style guide pattern structure

= 0.13.0 =
* Rename theme from "Crowdfunding Theme" to "Crowdfunding Platform"
* Update repository URLs and build commands
* Regenerate translation files with new theme name

= 0.12.1 =
* Update theme screenshot with current design

= 0.12.0 =
* Improve WordPress.org compliance with updated readme.txt documentation
* Add internationalization (i18n) functions to all campaign, homepage, and starter patterns
* Add proper escaping for campaign section patterns and reward card HTML output
* Enhance style guide pattern with complete theme.json coverage
* Consolidate button styles to canonical DRY system
* Add search field to campaign archive filters
* Update font family system to semantic naming for better consistency
* Replace contractions with full words in all translation strings
* Replace campaign images with single placeholder for licensing compliance

= 0.11.0 =
* Add campaign-specific search results layouts with funding progress display
* Improve campaign archive and taxonomy template handling with security fixes
* Add conditional navigation menus with authentication state handling
* Standardize campaign grid visual styling with new row-first layout option
* Replace hardcoded CSS values with theme.json design tokens throughout
* Fix progress bar rendering with thousands separators
* Fix text domain inconsistencies
* Update translation files

= 0.10.1 =
* Add 'micro' font size for improved typography options
* Use WordPress standard CSS custom properties for better theme compatibility

= 0.10.0 =
* Replace campaign-sections pattern with 4 dynamic patterns for better modularity
* Implement comprehensive CSS optimization with custom properties system
* Fix block validation errors for heading blocks with margin styles
* Improve CSS architecture and reduce specificity conflicts
* Add hook-based reward card patterns with improved naming
* Enhanced pattern organization and reusability

= 0.9.1 =
* Implement hook-based dynamic pattern system for plugin integration
* Add apply_filters() support to campaign patterns for real-time data
* Create child theme architecture foundation

= 0.9.0 =
* Complete WordPress.org Theme Unit Test compatibility via TDD approach
* Implement progressive gradient reveal for progress bars
* Enhanced blog roll, search, and single post template improvements
* Add visual styling for WordPress sticky posts
* Improve CSS specificity and maintainability
* Eliminate DRY violations in campaign reward patterns
* Add comprehensive accessibility framework and automated testing
* Add end-to-end testing with Playwright
* Reorganize repository structure for professional development workflow

= 0.8.0 =
* Add Pattern Registration API for plugin integration
* Allow crowdfunding plugins to register custom patterns
* Add flipped hero pattern with image left layout
* Add horizontal rewards pattern variant for layout variety
* Add progress bar styling to theme.json for Site Editor integration
* Add starter content patterns for page creation modal
* Add comprehensive child theme testing and documentation
* Add comprehensive font attributions to readme.txt

= 0.7.0 =
* Major code refactoring for DRY principles and maintainability
* Add proper child theme support with complete function overrides
* Remove unused font files and optimize assets
* Fix alignment issues and mobile/tablet responsiveness
* Reorganize CSS structure for easier maintenance
* Add campaign tabs pattern and improve existing patterns
* Complete internationalization (i18n) setup with proper textdomain loading
* Implement security improvements with nonces and capability checks
* Move inline JavaScript to external file for WordPress.org compliance

= 0.6.0 =
* Add campaign rewards pattern and pattern demos
* Resolve WordPress editor validation issues and conflicts
* Fix font family inconsistencies and adjust pattern font sizes
* Improve header and footer alignment
* Add campaign page demo combining multiple patterns
* Enhanced pattern development with inspiration from Twenty Twenty-Five
* Separate development features from production code
* Make demo page creation optional and WordPress.org compliant

= 0.5.0 =
* Accessibility improvements for WCAG 2.1 AA compliance
* Fix default patterns to use full container width
* Remove non-crowdfunding patterns for focused functionality
* Add pattern cache clearing functionality for development
* Font size adjustments and design token consistency
* Template and style variation enhancements

= 0.4.0 =
* Initial foundation release
* Full Site Editing support with core templates
* 8+ custom block patterns for crowdfunding layouts
* Progress bar theming integration with Site Editor
* 5 style variations including minimal and professional themes
* Mobile-responsive design with fluid typography
* Translation ready framework
* WordPress.org coding standards compliance
* Plugin compatibility foundation

== Support ==

For support, please visit the WordPress.org theme support forums or check the theme documentation.

== Credits ==

* Built using Twenty Twenty-Five as a reference for WordPress best practices
* Font files included: Inter, Literata, IBM Plex Mono (see Copyright section for complete attribution)
* Follows WordPress.org theme review guidelines
* Accessibility testing and implementation based on WCAG 2.1 AA standards

== Copyright ==

Crowdfunding Platform WordPress Theme, (C) 2024 Ignition WP LLC
Crowdfunding Platform is distributed under the terms of the GNU GPL.

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. See the
GNU General Public License for more details.

This theme bundles the following third-party resources:

=== Fonts ===

Inter Font
Copyright (c) 2016-2020 The Inter Project Authors.
License: SIL Open Font License 1.1 (https://opensource.org/licenses/OFL-1.1)
Source: https://github.com/rsms/inter

IBM Plex Mono Font
Copyright 2017 IBM Corp.
License: SIL Open Font License 1.1 (https://opensource.org/licenses/OFL-1.1)
Source: https://github.com/IBM/plex

Literata Font
Copyright: The Literata Project Authors
License: SIL Open Font License 1.1 (https://opensource.org/licenses/OFL-1.1)
Source: https://github.com/googlefonts/literata

=== Images ===

Screenshot (screenshot.png)
Theme screenshot composite image containing three CC0 licensed photographs:

"Engineering and Computer Science Library" by Open Grid Scheduler / Grid Engine
License: CC0 1.0 (https://creativecommons.org/publicdomain/zero/1.0/)
Source: https://www.flickr.com/photos/29155878@N03/17077590276

"Fulbright MENA Re-Entry Workshop Community Service - Potomac River Cleanup" by Bureau of Educational & Cultural Affairs
License: CC0 1.0 (https://creativecommons.org/publicdomain/zero/1.0/)
Source: https://www.flickr.com/photos/45717276@N08/40992903022

"City Hall Community Garden" by Dennis S. Hurd
License: CC0 1.0 (https://creativecommons.org/publicdomain/zero/1.0/)
Source: https://www.flickr.com/photos/43296902@N00/52370093610

Campaign placeholder image (assets/images/placeholder-campaign.webp)
Simple gradient placeholder created for theme demonstration purposes.
License: GNU GPL (same as theme)
No third-party attribution required.