# Kidearn Preschool

Kidearn Preschool is a hybrid Gutenberg theme rebuilt from the supplied Kidearn preschool HTML design. It uses native WordPress records for dynamic content and Gutenberg blocks for editorial page sections.

## Installation

1. In WordPress, open **Appearance → Themes → Add New → Upload Theme**.
2. Upload `kidearn-preschool.zip`, install it, and activate **Kidearn Preschool**.
3. Open **Import** in the WordPress administrator menu.
4. Select **Import demo site**. The importer creates the pages, media, menus, settings, posts, programs, events, teachers, taxonomies, and optional WooCommerce demo products.

The importer uses stable demo markers. Running it again updates or reuses its records instead of creating uncontrolled duplicates.

## Editing the homepage

Open **Pages → Home → Edit**. The homepage is composed of core Gutenberg blocks plus dynamic Kidearn blocks. Headings, text, images, buttons, colors, spacing, and section order can be edited in the normal block editor.

The importer also creates Home Two, Home Three, and Home Four as alternate editable compositions. Assign one under **Settings → Reading** to make it the front page.

## Structured content

- **Programs**: age range, class size, session time, and tuition fields; age-group taxonomy.
- **Events**: start/end dates, venue, address, and registration URL; event-type taxonomy.
- **Teachers**: role, experience, email, phone, and social profile fields; specialty taxonomy.
- **Posts**: standard WordPress Posts are used for news and articles.

These fields are available in Gutenberg document panels. ACF is not required.

## Dynamic Gutenberg blocks

- Program Grid
- Event List
- Teacher Grid
- Contact Form
- Newsletter Form

The listing blocks query WordPress records dynamically. Their editor sidebars control item count, columns, taxonomy filters, ordering, and section labels where relevant.

## Menus and footer

Edit menus under **Appearance → Menus**. The theme registers Primary, Footer, Footer Secondary, and Legal locations. Footer contact information, description, headings, social links, and copyright text are under **Appearance → Customize → Footer**. The footer gallery and blog sidebar use block widgets under **Appearance → Widgets**.

## Global styles

`theme.json` provides the Kidearn color palette, fluid typography, spacing scale, content widths, button styling, border controls, and shadows in Gutenberg. Classic-theme settings such as the site logo and site icon remain available in the Customizer.

## WooCommerce

WooCommerce is optional. When active, the theme declares WooCommerce support and the importer can create a small demo catalog and assign Shop, Cart, Checkout, and My Account pages. WooCommerce itself is not bundled.

## Forms

The contact and newsletter blocks use WordPress nonces, validation, honeypots, request throttling, accessible status feedback, and `wp_mail()`. Messages are sent to the site administrator email unless filtered by site code.

## Important notes

- No page-builder plugin is required.
- No proprietary plugin or font package is bundled.
- Demo illustrations are local, lightweight assets created for this theme.
- For production email delivery, configure a reputable SMTP or transactional mail plugin.
