PHPackages                             imagewize/callandor - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. imagewize/callandor

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

imagewize/callandor
===================

Pattern library for Sage 11 hybrid themes with Tailwind CSS and theme.json support

v2.0.2(2mo ago)094↓50%MITPHPPHP >=8.2

Since Oct 27Pushed 2mo agoCompare

[ Source](https://github.com/imagewize/callandor)[ Packagist](https://packagist.org/packages/imagewize/callandor)[ Docs](https://github.com/imagewize/callandor)[ RSS](/packages/imagewize-callandor/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (25)Used By (0)

 [![Callandor Plugin](assets/images/callandor-logo.svg)](assets/images/callandor-logo.svg)Callandor
=========

[](#callandor)

Block Pattern Library for the [Nynaeve Theme](https://github.com/imagewize/nynaeve)

[![Total Downloads](https://camo.githubusercontent.com/2d2881f91569408002efd30a99731edb1af71582c57812eb233b8e2f92def68c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696d61676577697a652f63616c6c616e646f722e737667)](https://packagist.org/packages/imagewize/callandor)[![Latest Stable Version](https://camo.githubusercontent.com/5ca2ebd20ae0e64660da63e31cc188e425840fcb815705225690afec4490111f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696d61676577697a652f63616c6c616e646f722e737667)](https://packagist.org/packages/imagewize/callandor)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

**Callandor** is a WordPress block pattern library plugin built specifically for the **[Nynaeve Theme](https://github.com/imagewize/nynaeve)** by Imagewize. It delivers professionally designed, business-focused block patterns that integrate seamlessly with Nynaeve's `theme.json` design system, Tailwind CSS utility classes, and hybrid theme architecture (Sage 11).

> **Primary Target:** Callandor is built and maintained for the **[Nynaeve Theme](https://github.com/imagewize/nynaeve)**. All patterns are designed, tested, and optimized against Nynaeve's design tokens (colors, typography, and spacing). While the plugin can work with other non-block/hybrid themes that share compatible `theme.json` settings, Nynaeve integration is the primary focus.

> **Note for Block Theme Users:** If you're using a full block theme (FSE theme), you don't need this plugin. Block themes can load patterns directly from the theme's `patterns/` directory without requiring PHP registration. This plugin is specifically for classic themes, hybrid themes, and any theme that cannot load patterns natively.

Features
--------

[](#features)

- **Nynaeve-First Design**: All patterns built against Nynaeve's design tokens, color palette, typography, and spacing system
- **Theme Integration**: Seamlessly integrates with theme.json colors, typography, and spacing
- **Tailwind CSS**: Built with Tailwind utility classes for modern, responsive designs
- **9 Professional Patterns**: Ready-to-use patterns for hero sections, features, CTAs, testimonials, pricing, team, and contact sections
- **Pattern Caching**: Optimized performance with 24-hour transient caching for faster page loads
- **Business-Focused**: Designed for SME businesses with focus on conversions and ROI
- **Easy Management**: Simple admin interface to browse and manage patterns with cache control
- **Fully Responsive**: Mobile-first designs that look great on all devices
- **Developer Friendly**: Clean code following WordPress standards with full Composer support

Available Patterns
------------------

[](#available-patterns)

The plugin includes these professionally-designed patterns (all using WordPress native blocks with theme.json integration):

**Hero Sections**

- **Hero Section with Call to Action** - Classic hero with headline, description, and prominent CTA button on colored background
- **Hero Two-Tone** - Modern hero with two-tone heading, dual CTA buttons, and image in responsive two-column layout

**Features & Services**

- **3-Column Feature Grid** - Showcase services with icon placeholders, headings, and descriptions in clean grid layout

**Call-to-Actions**

- **Newsletter Signup CTA** - Email capture with heading, description, and email input form on accent background

**Social Proof**

- **Client Testimonial Cards** - Professional testimonial display with quote, author name, and company in card format
- **Client Reviews - Orange Background** - Vibrant testimonial section with three reviews on bold orange background with profile images

**E-Commerce & Pricing**

- **3-Column Pricing Table** - Service package comparison with features list, pricing, and CTA buttons

**Team & About**

- **Team Member Grid** - Professional team profiles with photos, names, roles, and bios in 3-column layout

**Contact & Info**

- **Contact Information Section** - Office hours, contact details, and physical address in organized 3-column card layout

All patterns are fully responsive, use Nynaeve's theme.json design tokens, and integrate seamlessly with WordPress's native block editor.

Requirements
------------

[](#requirements)

- WordPress 6.6+
- PHP 8.2+
- **Nynaeve Theme** (primary) or another non-block/hybrid theme with compatible `theme.json`
- Gutenberg block editor
- theme.json support (required for full styling)

**Not Required For:**

- Full block themes (FSE themes) - they have built-in pattern support

Theme Compatibility & Design Tokens
---------------------------------------

[](#theme-compatibility--design-tokens)

All Callandor patterns are designed and tested against the **Nynaeve Theme** by Imagewize. Patterns rely on specific design tokens (color slugs, font size slugs, font families, and spacing presets) defined in Nynaeve's `theme.json`.

### Nynaeve Design Tokens Used

[](#nynaeve-design-tokens-used)

Token typeSlugs usedColors`primary`, `primary-accent`, `primary-dark`, `main`, `main-accent`, `base`, `secondary`, `tertiary`, `border-light`, `border-dark`Font sizes`xs`, `sm`, `base`, `lg`, `xl`, `2xl`, `3xl`, `4xl`, `5xl`, `6xl`, `7xl`Font families`montserrat`, `open-sans`, `menlo`Spacing`20`, `40`, `50`, `60`### Using with Other Themes

[](#using-with-other-themes)

Callandor can work with other non-block or hybrid themes, but visual appearance may differ if your theme does not define the same design tokens. To adapt patterns to a different theme, either:

1. **Define matching token slugs** in your theme's `theme.json` using the same slug names
2. **Override pattern styles** via your theme stylesheet after insertion
3. **Edit the pattern** after inserting — all typography uses WordPress font size slugs so you can change sizes via the block toolbar

Installation
------------

[](#installation)

### Via Composer (Recommended for Bedrock)

[](#via-composer-recommended-for-bedrock)

```
composer require imagewize/callandor
```

### Manual Installation

[](#manual-installation)

1. Download the latest release
2. Upload to `/wp-content/plugins/callandor`
3. Activate through WordPress admin
4. Go to **Appearance → Callandor Patterns**

### Development Installation

[](#development-installation)

```
cd wp-content/plugins
git clone https://github.com/imagewize/callandor.git
cd callandor
composer install --dev
```

Usage
-----

[](#usage)

### Inserting Patterns

[](#inserting-patterns)

1. Open the WordPress block editor
2. Click the **+** button to add a block
3. Navigate to the **Patterns** tab
4. Find patterns under Callandor categories (Hero Sections, Features, etc.)
5. Click to insert and customize

### Admin Interface

[](#admin-interface)

Access the pattern management interface:

- Navigate to **Appearance → Callandor Patterns**
- View all available patterns organized by category
- See pattern metadata and slugs
- Clear pattern cache for development workflow
- Configure plugin settings (license key for Phase 2)

### Theme Integration

[](#theme-integration)

Patterns automatically use Nynaeve's design tokens from `theme.json`:

**Colors:**

- `primary` (#017cb6) - Brand blue
- `primary-accent` (#e6f4fb) - Light blue accent
- `base` (#ffffff) - White background
- `main` (#171b23) - Text black
- Additional semantic colors

**Typography:**

- Font families: `open-sans`, `montserrat`, `menlo`
- Font sizes (xs through 7xl)
- Consistent spacing scale

Development
-----------

[](#development)

### Project Structure

[](#project-structure)

```
callandor/
├── callandor.php                 # Main plugin file
├── composer.json                 # Composer configuration
├── includes/                     # PHP classes
│   ├── class-pattern-loader.php  # Pattern registration
│   └── class-admin-settings.php  # Admin interface
├── patterns/                     # Pattern files
│   ├── hero/
│   ├── cta/
│   ├── features/
│   ├── testimonials/
│   └── pricing/
├── assets/                       # CSS/JS assets
│   ├── css/admin.css
│   └── js/admin.js
└── docs/
    └── PLUGIN_SPEC.md           # Build specification

```

### Creating Custom Patterns

[](#creating-custom-patterns)

Create a new PHP file in the appropriate `patterns/` subdirectory:

```