klytos-page-structure

Complete reference for page data structure, creation, editing, and templates in Klytos CMS. Use when creating pages, updating pages, querying pages, understanding page fields, using page templates, working with hierarchical URLs, managing page content, using page hooks, editing content with Gutenberg blocks, or the PageManager API.

インストールへ移動

リポジトリ: joseconti/klytos
ソースの最終更新活動: 2026年4月5日 13:57
検出された SKILL.md の言語: 英語
スター: 12
フォーク: 2

インストール方法

デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。

ソースファイルを確認

インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。

検索に戻るインストールに戻る

name	klytos-page-structure
description	Complete reference for page data structure, creation, editing, and templates in Klytos CMS. Use when creating pages, updating pages, querying pages, understanding page fields, using page templates, working with hierarchical URLs, managing page content, using page hooks, editing content with Gutenberg blocks, or the PageManager API.

Klytos Page Structure Reference

When to Use This Skill

Use this reference whenever you need to create, edit, delete, or query pages in Klytos CMS — whether via MCP tools, the admin panel, or plugin code.

Page Data Structure

Every page in Klytos has the following fields:

Field	Type	Description
`slug`	string	Required. Unique URL identifier. Supports hierarchical paths: `"services/marketing"`
`parent_slug`	string	Auto-derived from slug. For `"services/marketing"` → `"services"`
`title`	string	Required. Page title for `<title>` and `<h1>`
`content_html`	string	Full HTML body content (Gutenberg block markup recommended)
`content_blocks`	string	Gutenberg block JSON (if using block editor)
`meta_description`	string	SEO meta description (max 160 chars)

klytos_add_action( 'page.status_changed', function ( array $page, string $oldStatus, string $newStatus ): void {
    // React to status transitions
});

Template	Description	Use Case
`default`	Standard layout with header, navigation, breadcrumbs, footer	Most pages
`blank`	Minimal structure, no header/footer	Full custom control
`blog-post`	Article layout, narrow content width (720px), meta info	Blog posts
`landing`	Hero section with gradient, multiple content sections	Marketing pages

Variable	Description
`{{page_content}}`	HTML content from page editor
`{{page_title}}`	Page title
`{{site_name}}`	Site brand name
`{{meta_description}}`	SEO description
`{{page_lang}}`	Language code
`{{page_slug}}`	URL slug
`{{menu_html}}`	Navigation menu HTML
`{{footer_html}}`	Generated footer
`{{base_path}}`	Relative path to root
`{{site_url}}`	Absolute site URL
`{{og_image}}`	Open Graph image
`{{custom_css}}`	Page-specific inline CSS
`{{custom_js}}`	Page-specific inline JS
`{{head_scripts}}`	Analytics head scripts
`{{body_scripts}}`	Analytics body scripts
`{{breadcrumbs}}`	Schema.org breadcrumb navigation
`{{hreflang_tags}}`	Multilingual alternate links
`{{seo_meta_tags}}`	All SEO meta tags (OG, Twitter, JSON-LD)
`{{google_fonts_html}}`	Google Fonts link tags
`{{css_variables}}`	`:root` CSS variables block
`{{tagline}}`	Site tagline
`{{site_tagline}}`	Alias for `{{tagline}}`

$pages = klytos_app()->getPages();

$page = $pages->create([
    'slug'             => 'about',
    'title'            => 'About Us',
    'content_html'     => '<!-- wp:paragraph --><p>Welcome...</p><!-- /wp:paragraph -->',
    'meta_description' => 'Learn about our company and mission.',
    'template'         => 'default',
    'status'           => 'published',
    'lang'             => 'en',
]);

$page = $pages->update('about', [
    'title'        => 'About Our Company',
    'status'       => 'published',
    'custom_css'   => '.about-hero { background: #f0f0f0; }',
]);

$deleted = $pages->delete('about'); // returns bool

$page     = $pages->get('about');                         // Single page
$exists   = $pages->exists('about');                      // bool
$all      = $pages->list('published', 'en', 50, 0);      // List with filters
$count    = $pages->count('published');                    // Count
$children = $pages->getChildren('services', 'published'); // Child pages

$crumbs = $pages->getBreadcrumbs('services/marketing', '/');
// [['title' => 'Home', 'url' => '/'], ['title' => 'Services', 'url' => '/services/'], ...]

$html = $pages->renderBreadcrumbs('services/marketing', '/');
// Returns HTML with JSON-LD schema.org markup

{
    "post_type": "page"
}

{
    "slug": "about",
    "title": "About Us",
    "content_html": "<!-- wp:paragraph --><p>Welcome...</p><!-- /wp:paragraph -->",
    "meta_description": "Learn about our company.",
    "template": "default",
    "status": "published",
    "lang": "en"
}

{
    "slug": "about",
    "title": "About Our Company",
    "status": "published"
}

{
    "slug": "about"
}

{
    "slug": "about"
}

{
    "status": "published",
    "lang": "en",
    "post_type": "page",
    "limit": 50,
    "offset": 0
}

services/                    → parent page
services/marketing/          → child page (parent_slug = "services")
services/marketing/seo/      → grandchild page

Hook	Type	Arguments
`page.before_save`	action	`array $page, string $action` (`'create'` or `'update'`)
`page.after_save`	action	`array $page, string $action`
`page.before_delete`	action	`string $slug`
`page.after_delete`	action	`string $slug`
`page.status_changed`	action	`array $page, string $oldStatus, string $newStatus`
`page.content`	filter	`string $html` — modify content before render

klytos_add_filter('page.content', function (string $html): string {
    $wordCount = str_word_count(strip_tags($html));
    $minutes   = max(1, (int) ceil($wordCount / 200));
    return "<p class=\"reading-time\">{$minutes} min read</p>" . $html;
});

<!-- wp:heading {"level":2} -->
<h2 class="wp-block-heading">About Us</h2>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>We are a company dedicated to excellence.</p>
<!-- /wp:paragraph -->

<!-- wp:image {"url":"/assets/images/team.jpg","alt":"Our team"} -->
<figure class="wp-block-image"><img src="/assets/images/team.jpg" alt="Our team"/></figure>
<!-- /wp:image -->