=== FansPaysite ===
Contributors: videowhisper
Author: VideoWhisper.com
Author URI: https://videowhisper.com
Requires at least: 5.1
Tested up to: 6.8
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Stable tag: 2.2

FansPaysite is a theme designed for digital content creators with three archive display modes, flexible typography presets, and optional CDN loading for bundled libraries.

== Description ==
FansPaysite is a mobile-first WordPress theme for creator and membership sites. It includes flexible left-sidebar and top-bar layouts, dark and light modes, menu icons, block editor support, reusable patterns, Elementor-compatible page templates, and theme integrations for WooCommerce and BuddyPress.

Key features:
- Three archive display modes: Classic, Fullpage, and Boxes
- Appearance > FansPaysite admin page for skins, import/export, and advanced settings
- Typography presets: System, Inter, Nunito, Lato, Roboto, Open Sans, Poppins, Georgia, Merriweather
- Optional CDN loading for bundled libraries, disabled by default for WordPress.org-friendly local bundling
- Conditional loading for theme WooCommerce and BuddyPress integration CSS
- Asynchronous Google Fonts loading when a webfont preset is selected
- Font Awesome icon picker for menu items
- Accessibility and keyboard-navigation improvements for menus and fullpage archives

=== Archive Display Modes ===

The theme offers three distinct ways to display post archives (blog, category, search results):

1. Classic - Enhanced card layout with thumbnail, title, excerpt, and metadata.
2. Fullpage - Social media style snap-scroll view where each post fills the viewport.
3. Boxes - Responsive grid cards with author avatar, relative time, and post format badges.

All modes support:
- All core post formats
- Auto-pagination on scroll
- Comments count display
- Plugin action hooks for extensions
- More button for full post view

Configure via Appearance > Customize > FansPaysite Theme > Post Display > Archive Display Mode.

== Theme Structure ==

=== File Organization ===
fanspaysite/
  style.css            - Main stylesheet, theme metadata, layout CSS, design tokens
  functions.php        - Theme setup, sidebar registration, include loader
  header.php           - Sidebar or top-bar header output
  footer.php           - Footer, right sidebar, wp_footer
  index.php            - Archive entry point
  page.php             - Single page template
  single.php           - Single post template
  comments.php         - Comment list and form
  editor-style.css     - Block editor styles
  screenshot.jpg       - Theme screenshot for WP admin
  default.png          - Default post thumbnail fallback

  inc/
    customizer.php     - Customizer settings for layout, colors, typography, post display, footer
    enqueue.php        - Theme asset loading, bundled/CDN library resolver, resource hints, conditional styles
    menu.php           - Menu walkers, icon picker, icon mappings
    mode.php           - Theme mode logic, typography CSS, Google Fonts loading, AJAX preference updates
    skins.php          - Appearance > FansPaysite admin page, skins, import/export, Advanced tab
    blocks.php         - Block patterns and styles
    comments.php       - Custom comment callback
    woocommerce.php    - WooCommerce support and conditional theme WooCommerce CSS
    buddypress.php     - BuddyPress support and conditional theme BuddyPress CSS

  template-parts/
    archive/           - Archive mode templates
    content-*.php      - Content partials

  js/
    archive.js         - Fullpage archive behavior and auto-pagination
    menu.js            - Menu dropdown behavior and mobile handling
    theme.js           - Frontend theme mode switcher
    fa-picker.js       - Menu icon picker initialization

  css/
    woocommerce.css    - Theme WooCommerce integration styles
    buddypress.css     - Theme BuddyPress integration styles

  lib/
    fa/                - Font Awesome Free 7.1.0
    fa-picker/         - Font Awesome Icon Picker 3.2.0
    fomantic/          - Fomantic-UI 2.9.4

  languages/          - Translation files

=== Architecture Overview ===

Layout System:
  The theme uses a flexbox-based full-viewport layout with two main variants.

  Left Sidebar Layout:
    .site-wrapper (flex row, 100vh)
      .site-sidebar
      .site-content
      .site-sidebar-right

  Top Bar Layout:
    .site-wrapper (flex column, 100vh)
      .site-topbar
      .site-topbar-expanded
      .site-content-wrapper

Typography:
  The theme supports multiple typography presets. Google Fonts are only requested
  for presets that need them, while system and serif stacks stay local.

Menus:
  Custom menu walkers render icon-based menus for both layout modes. Menu items
  can use a custom icon class, an automatic title-to-icon mapping, or a fallback icon.

Skins and Settings:
  Appearance > FansPaysite includes:
  - Skins tab for applying and saving skins
  - Import / Export tab for portability
  - Advanced tab with optional CDN loading for bundled libraries

Bundled Libraries:
  - Fomantic UI 2.9.4 loaded per component instead of the monolithic bundle
  - Font Awesome Free 7.1.0 with local font-display: swap for bundled icon fonts
  - Font Awesome Icon Picker 3.2.0 for menu icon selection in wp-admin

Performance Notes:
  - Theme WooCommerce CSS only loads on WooCommerce screens
  - Theme BuddyPress CSS only loads on BuddyPress screens
  - Google Fonts are output asynchronously with resource hints
  - Bundled libraries can optionally load from jsDelivr CDN when enabled in Advanced settings

=== Customizer Settings Reference ===

Section: FansPaysite Theme
  fanspaysite_layout                    - Layout: left-sidebar/top-bar
  fanspaysite_default_theme_mode        - Default mode: light/dark/auto
  fanspaysite_show_theme_mode_switcher  - Show frontend switcher
  fanspaysite_menu_display_mode         - Main menu display mode
  fanspaysite_submenu_display_mode      - Secondary menu display mode
  fanspaysite_submenu_hover             - Submenu hover behavior
  fanspaysite_sticky_header             - Sticky menu bar / top bar
  fanspaysite_content_width             - Content width: default/wide/boxed
  fanspaysite_show_right_sidebar        - Right sidebar visibility: auto/yes/no
  fanspaysite_font_preset               - Typography preset selection
  fanspaysite_archive_display           - Archive mode: classic/fullpage/boxes
  default_post_thumbnail                - Default thumbnail image
  display_title                         - Show post title
  display_category                      - Show post category
  display_tags                          - Show post tags
  display_date                          - Show post date
  display_author                        - Show post author
  light_mode_background_color           - Light background color
  light_mode_text_color                 - Light text color
  light_mode_link_color                 - Light link color
  dark_mode_background_color            - Dark background color
  dark_mode_text_color                  - Dark text color
  dark_mode_link_color                  - Dark link color

=== Development Notes ===
  - Theme assets use file modification time for cache-busting where practical
  - Bundled/CDN library versions should stay aligned when updated
  - Use conditional loading for theme-owned integration CSS before broader asset refactors
  - Theme strings are translation-ready with the fanspaysite text domain

== License ==
FansPaysite WordPress Theme, Copyright 2024 VideoWhisper.com .
FansPaysite is distributed under the terms of the GNU GPL.

== Frequently Asked Questions ==

= How can I change the icons in the menu? =
Open Appearance > Menus, expand a menu item, and edit the FansPaysite icon field. The built-in icon picker can help select a Font Awesome class.

= How do I switch skins or layouts? =
Go to Appearance > FansPaysite. You can apply built-in skins, save your current settings as a custom skin, or use the top-bar / left-sidebar layouts.

= Can I load bundled libraries from a CDN? =
Yes. Go to Appearance > FansPaysite > Advanced and enable the cloud/CDN library option. It is disabled by default so the theme stays compatible with WordPress repository expectations.

= Does the theme support WooCommerce and BuddyPress? =
Yes. FansPaysite includes theme integration styles for both and now loads those styles only on relevant screens.

= Does this require a separate plugin? =
No. The theme can be used on its own, though it can complement creator and membership plugins.

= How can I get support or customizations? =
You can get support, configuration assistance, and customization services from VideoWhisper: https://consult.videowhisper.com

== Changelog ==

= 2.2 =
* Typography: Added preset options for Lato, Roboto, Open Sans, Poppins, and Merriweather
* Typography: Fixed top-bar text labels so wider fonts stay centered and avoid awkward left-aligned wraps
* Admin: Added Advanced tab in Appearance > FansPaysite with optional CDN loading for bundled libraries
* Libraries: Updated bundled and CDN-loaded assets to Font Awesome Free 7.1.0, Fomantic-UI 2.9.4, and Font Awesome Icon Picker 3.2.0
* Performance: Theme WooCommerce CSS now loads only on WooCommerce screens
* Performance: Theme BuddyPress CSS now loads only on BuddyPress screens
* Performance: Google Fonts load asynchronously with resource hints when a webfont preset is selected
* Performance: Local Font Awesome bundle now uses font-display: swap for icon fonts

= 2.1 =
* Performance: Fomantic UI loaded as individual components instead of the monolithic bundle
* Performance: FOUC fix by resolving theme mode earlier in the document
* Performance: Font preload for Font Awesome and mobile usability improvements
* Gutenberg: Added theme.json, patterns, and improved editor styling
* Elementor: Added Full Width and Blank Canvas page templates
* Customizer: Added sticky header, content width, right sidebar toggle, font presets, and footer columns
* Footer: Configurable widget columns
