Amazonで商品を見る セール会場へ

Arkhe│テーマ・関連プラグイン全機能リファレンス|ブロック・フック・設定の一覧

AIにArkheのカスタマイズを頼むと、存在しないフック名や、SWELLの書き方が混ざった答えが返ってくることがあります。

Arkheはテーマ本体が無料で、機能の多くを専用プラグインに分けているため、どこに何があるかが見えにくいのが原因です。

そこで、Arkhe本体と関連プラグインを解析して、外から呼べる名前を全部一覧にしました。

この記事をそのままAIに渡せば、テーマとプラグインの輪郭を把握させられます。

種類数どこにあるか
ブロック34種(無料で使えるのは26種)Arkhe Blocks / Pro
アクションフック55種テーマ本体
フィルターフック61種テーマ本体
テーマ設定71項目テーマ本体(カスタマイザー)
テンプレート部品53個テーマ本体
CSS変数62種+57種テーマ本体+Arkhe Blocks
ユーティリティクラス58種テーマ本体
記事ごとの設定12種Arkhe Toolkit
ショートコード6種Arkhe Toolkit

最終調査日は2026年9月26日です。

数え方と、解析に使った版は記事の最後に書いています。

テーマやプラグインのソースコードは載せていません。

ここに並べたのは、外から呼ぶための名前だけです。

目次

著者

WEB制作をしているデジタルノマド
WordPressのカスタマイズが好きで、色々と自作しています。

WordPressのカスタマイズに困ったらご相談ください!

Arkheの製品構成と、無料・有料の境目

最初に、どれが無料でどれが有料かを整理します。

AIに頼むとき、入っていないプラグインの機能を前提にされるのがいちばん多い失敗だからです。

製品最新版入手方法主な役割
Arkhe(テーマ本体)3.14無料・WordPress.orgレイアウト、カスタマイザー、フック
Arkhe Blocks2.27.1無料・WordPress.orgブロックの無料版
Arkhe Blocks Pro2.30Pro Pack/買い切り全ブロック、カスタム書式、コアブロックの拡張
Arkhe Toolkit1.11Pro Pack/買い切り高速化、ウィジェット追加、記事ごとの設定、コア機能の停止
Arkhe CSS Editor1.2.2Pro Pack管理画面でCSSを編集
Arkhe Wookit1.0(公式の更新情報)単体の買い切りWooCommerceの見た目をArkheに合わせる

Arkhe Pro Packは、Blocks Pro・Toolkit・CSS Editorの3つを年額で使える契約です。

公式ショップでは、個人ライセンスが年6,600円、制作ライセンスが年9,900円(いずれも税込)と案内されています。

Blocks ProとToolkitには買い切り版もあります。

買い切り版は購入した時点の版しか受け取れないので、あとから出た版を使うには契約か再購入が要ります。

Arkhe 3.14とBlocks Pro 2.30は、2026年8月20日にWordPress 7.1への対応として公開されました。

テーマ本体(Arkhe 3.14.0)

Arkhe本体は、見た目の装飾を最小限にして、差し込み口を多く用意する設計です。

アクションフックが55種あり、ヘッダーやフッターの内側まで細かく差し込めます。

フックの数は調査した版と数え方で変わります。テーマ間の数の比較だけでは、変更できる範囲は判断できません。

Arkheでは、「どこに何を出すか」をフックで足していく作り方に向いています。

テーマ設定(71項目)

カスタマイザーの項目の実体です。

値は arkhe_settings という1つのオプションに、まとめて保存されています。

群項目数主なキー
カラー5color_main、color_text、color_link、color_bg、color_gray
コンテンツ幅2container_width、slim_width
代替画像1no_image
パンくずリスト3breadcrumbs_pos、breadcrumbs_home_text、breadcrumbs_set_home_page
スムーススクロール1smooth_scroll
ヘッダー19header_color_bg、header_color_txt、head_logo_overlay、header_overlay_on_page、color_text_overlay_header、logo_size_pc…
フッター4footer_color_bg、footer_color_txt、show_pagetop、copyright
サイドバー4show_sidebar_top、show_sidebar_page、show_sidebar_post、show_sidebar_archive
投稿リスト10post_list_layout、excerpt_length、show_list_cat、show_list_date、show_list_mod、show_list_author…
固定ページ設定4page_title_pos、title_bg_filter、ttlbg_overlay_color、ttlbg_overlay_opacity
投稿ページ7show_entry_posted、show_entry_modified、show_entry_cat、show_entry_tag、show_entry_custom_tax、show_entry_author…
下部エリア11show_foot_terms、show_prev_next_link、show_author_box、show_comments、show_img_shadow、show_related_posts…

読むときは Arkhe::get_setting( 'キー' ) を使います。

初期値は Arkhe::get_default_setting( 'キー' ) で取れます。

// メインカラーを読む
$main = Arkhe::get_setting( 'color_main' );

// 全部まとめて配列で受け取る
$all = Arkhe::get_setting();

// 表示中だけ値を上書きする(保存はされない)
Arkhe::overwrite_setting( 'show_sidebar_post', false );

カスタマイザーのセクションは7つです。

セクションID中身
arkhe_section_global全体(色・幅・パンくずなど)
arkhe_section_headerヘッダー
arkhe_section_footerフッター
arkhe_section_sidebarサイドバー
arkhe_section_post_list投稿リスト(アーカイブ)
arkhe_section_single投稿ページ
arkhe_section_page固定ページ

アクションフック(55種)

出る場所ごとに分けて並べます。

名前の規則は、要素の外側が before_ と after_、内側が start_ と end_ です。

ヘッダー(5種)

  • arkhe_after_header
  • arkhe_before_header
  • arkhe_header_bar_content
  • arkhe_header_left_content
  • arkhe_header_right_content

ドロワーメニュー(3種)

  • arkhe_after_drawer_nav
  • arkhe_end_drawer_body
  • arkhe_start_drawer_body

サイドバー(2種)

  • arkhe_end_sidebar
  • arkhe_start_sidebar

フッター(7種)

  • arkhe_after_copyright
  • arkhe_after_footer
  • arkhe_before_copyright
  • arkhe_before_footer
  • arkhe_end_footer_inner
  • arkhe_start_footer_foot_content
  • arkhe_start_footer_inner

コンテンツ全体(2種)

  • arkhe_end_content
  • arkhe_start_content

投稿ページ(8種)

  • arkhe_after_author_name
  • arkhe_after_entry_content
  • arkhe_author_links
  • arkhe_before_entry_content
  • arkhe_end_entry_foot
  • arkhe_end_entry_main
  • arkhe_start_entry_foot
  • arkhe_start_entry_main

固定ページ(4種)

  • arkhe_after_page_content
  • arkhe_before_page_content
  • arkhe_end_page_main
  • arkhe_start_page_main

フロント・ブログページ(8種)

  • arkhe_after_front_content
  • arkhe_after_home_content
  • arkhe_before_front_content
  • arkhe_before_home_content
  • arkhe_end_front_main
  • arkhe_end_home_main
  • arkhe_start_front_main
  • arkhe_start_home_main

アーカイブ・検索・著者(10種)

  • arkhe_before_archive_post_list
  • arkhe_before_author_post_list
  • arkhe_before_search_post_list
  • arkhe_before_term_post_list
  • arkhe_end_archive_main
  • arkhe_end_author_main
  • arkhe_end_search_main
  • arkhe_start_archive_main
  • arkhe_start_author_main
  • arkhe_start_search_main

404ページ(4種)

  • arkhe_after_404_content
  • arkhe_before_404_content
  • arkhe_end_404_main
  • arkhe_start_404_main

テンプレート部品の前後(2種)

  • arkhe_did_get_part__{部品}
  • arkhe_pre_get_part__{部品}

ヘッダー上部の細い帯は、arkhe_header_bar_content に何かを登録したときだけ現れます。

何も登録しなければ、帯そのものが出力されません。

// ヘッダーの上に、お知らせの帯を出す
add_action( 'arkhe_header_bar_content', function () {
	echo '<p>年末年始の営業日のお知らせ</p>';
} );

フィルターフック(61種)

値を書き換える口です。

用途ごとに分けて並べます。

テンプレート部品(4種)

  • arkhe_part__{部品}
  • arkhe_part_args__{部品}
  • arkhe_part_cache__{部品}
  • arkhe_part_path__{部品}

表示する・しないの判定(12種)

  • arkhe_is_header_overlay
  • arkhe_is_show_comments
  • arkhe_is_show_sidebar
  • arkhe_is_show_ttltop
  • arkhe_show_author_box
  • arkhe_show_entry_thumb
  • arkhe_show_foot_terms
  • arkhe_show_prev_next_link
  • arkhe_show_related_posts
  • arkhe_show_term_description
  • arkhe_use_fse_blocks
  • arkhe_use_lazy_top_area

投稿リスト・関連記事(9種)

  • arkhe_list_layouts
  • arkhe_list_type_on_archive
  • arkhe_list_type_on_author
  • arkhe_list_type_on_home
  • arkhe_list_type_on_search
  • arkhe_list_type_on_term
  • arkhe_move_post_count_into_a
  • arkhe_related_area_title
  • arkhe_related_posts_args

タグの属性・class(6種)

  • arkhe_header_attrs
  • arkhe_main_body_attrs
  • arkhe_main_body_class
  • arkhe_main_class
  • arkhe_post_content_class
  • arkhe_root_attrs

ロゴ・画像(8種)

  • ark_get__head_logo_img
  • ark_the__thumbnail
  • arkhe_get_svg
  • arkhe_head_logo_overlay_url
  • arkhe_head_logo_sizes
  • arkhe_head_logo_url
  • arkhe_logo_tag
  • arkhe_ttlbg_img_id

見出し・文言(9種)

  • ark_the__tagline
  • arkhe_404_content
  • arkhe_404_title
  • arkhe_author_area_title
  • arkhe_no_posts_text
  • arkhe_page_subtitle
  • arkhe_search_title
  • arkhe_term_description
  • arkhe_top_area_excerpt

差し替えできる関数の出力(3種)

  • ark_get__term_links
  • ark_the__pnlink
  • ark_the__postdate

取得するデータ(6種)

  • arkhe_breadcrumbs_data
  • arkhe_breadcrumbs_position
  • arkhe_get_archive_data
  • arkhe_get_author_icon_data
  • arkhe_get_tax_of_post_type
  • arkhe_get_the_terms_data

その他(4種)

  • arkhe_alignwide_plus_width
  • arkhe_content_width
  • arkhe_customizer_args
  • arkhe_gnav_location_name

一つずつの引数とサンプルコードは、Arkhe│アクションフック・フィルターフック全まとめにまとめています。

サイドバーの有無を変えるときは、1点だけ注意があります。

固定ページで「1カラム」「2カラム」のテンプレートを選んでいると、arkhe_is_show_sidebar を通らずに決まります。

フィルターが効かないときは、テンプレートの指定を先に確かめてください。

// お問い合わせページだけサイドバーを消す
add_filter( 'arkhe_is_show_sidebar', function ( $show ) {
	if ( is_page( 'contact' ) ) {
		return false;
	}
	return $show;
} );

テンプレート部品(53個)

Arkheは get_template_part() ではなく、独自の Arkhe::get_part() で部品を読み込みます。

そのため、部品ごとに6種類のフックが自動で用意されます。

フック種類できること
arkhe_pre_get_part__{部品}アクション部品の直前に出力を足す
arkhe_part_args__{部品}フィルター部品に渡す引数を書き換える
arkhe_part_path__{部品}フィルター読み込むファイルを差し替える
arkhe_part_cache__{部品}フィルターキャッシュ済みのHTMLを返して読み込みを省く
arkhe_part__{部品}フィルター出力されたHTMLを書き換える
arkhe_did_get_part__{部品}アクション部品の直後に出力を足す

表の {部品} には single/foot/related_posts のように、template-parts/ からの場所を拡張子なしで入れます。

Arkhe Toolkitの「パーツキャッシュ」は、この arkhe_part_cache__ を使っています。

// 関連記事の直前に見出しを足す
add_action( 'arkhe_pre_get_part__single/foot/related_posts', function () {
	echo '<p class="u-fz-s">あわせて読みたい</p>';
} );

// 部品のHTMLを書き換える
add_filter( 'arkhe_part__other/breadcrumb', function ( $html, $args ) {
	return str_replace( 'Home', 'ホーム', $html );
}, 10, 2 );

ファイルで差し替えるなら、子テーマの template-parts/ に同じ名前で置きます。

探す順番は、子テーマ、プラグインが指定した場所、親テーマの順です。

場所部品
archive/archive、archive/title
archive_term/archive_term
footer/footer、footer/fix_btns、footer/modals
front/front
header/header、header/btn/drawer、header/btn/search、header/drawer_menu、header/gnav、header/header_bar、header/logo、header/logo/image、header/logo/text
home/home
other/other/author_box、other/breadcrumb、other/pagination
page/page、page/head、page/title
post_list/post_list/item/meta、post_list/item/meta/author、post_list/item/meta/category、post_list/item/meta/times、post_list/item/thumb、post_list/main_query、post_list/style/normal、post_list/style/related、post_list/style/simple、post_list/sub_query
sidebar/sidebar
single/single、single/foot、single/foot/meta、single/foot/post_author、single/foot/prev_next_link、single/foot/related_posts、single/head、single/head/meta、single/head/thumbnail、single/head/title、single/item/post_author、single/item/prev_next_link、single/item/related_posts、single/item/term_list、single/item/thumbnail
top_area/top_area、top_area/other、top_area/singular、top_area/term

差し替えできる関数(6つ)

次の関数は function_exists で包まれています。

子テーマの functions.php で同じ名前の関数を先に定義すると、テーマ側のものと入れ替わります。

関数出すもの
ark_get__head_logo_imgヘッダーのロゴ画像
ark_the__taglineキャッチフレーズ
ark_the__thumbnailアイキャッチ画像
ark_the__postdate投稿日・更新日
ark_the__pnlink前後の記事へのリンク
ark_get__submenu_toggle_btnサブメニューの開閉ボタン

関数ごと差し替えるより、同じ名前のフィルターで出力を書き換えるほうが、テーマの更新に強くなります。

テーマのクラスで使えるメソッド

すべて Arkhe:: から呼べます。

自作のコードでよく使うものだけ並べます。

メソッド用途
get_setting( $key )テーマ設定を読む
get_part( $slug, $args )テンプレート部品を読み込む
get_svg( $name ) / the_svg( $name )テーマ内蔵のアイコンを出す
get_image( $id, $args )遅延読み込みに対応した画像タグを作る
is_show_sidebar()サイドバーを出すページか
is_header_overlay()ヘッダーを重ねて表示しているか
is_show_ttltop()タイトルをコンテンツの上に出しているか
get_breadcrumbs_position()パンくずの位置
get_lazy_type()遅延読み込みの方式
is_use( $key )そのページで使われている機能か

ページテンプレート・メニュー位置・ウィジェットエリア

種類名前中身
ページテンプレートtemplates/one-column-slim.php1カラム(スリム幅)
ページテンプレートtemplates/one-column.php1カラム
ページテンプレートtemplates/two-column.php2カラム
メニュー位置header_menuグローバルナビ
メニュー位置drawer_menuドロワーメニュー
メニュー位置footer_menuフッター
ウィジェットsidebar-1サイドバー
ウィジェットdrawer-bottomドロワーメニューの下
ウィジェットfooter-1、footer-2フッター(2列)

CSS変数(62種)

接頭辞は --ark- です。

色や幅はカスタマイザーの値がこの変数に入るので、CSSで上書きするときの鍵になります。

変数中身
--ark-color_mainメインカラー
--ark-color_text文字色
--ark-color_linkリンク色
--ark-color_bg背景色
--ark-color_gray薄い灰色
--ark-container_widthサイトの幅
--ark-slim_widthスリム幅
--ark-header_heightヘッダーの高さ
--ark-width--sidebarサイドバーの幅
--ark-padding--container左右の余白
--ark-font_size本文の文字サイズ
--ark-line_height本文の行間
--ark-mtブロックの間の余白
--ark-fz--s小さい文字
--ark-fz--l大きい文字
--ark-drawerWドロワーメニューの幅

全部の名前は次のとおりです。

  • --ark-searchW、--ark-adminbar_height、--ark-color--border、--ark-height--full、--ark-mediatext--gap、--ark-mediatext--offsetX、--ark-mediatext--offsetY、--ark-mediatext--space、--ark-mt--inner、--ark-nav-padding--L、--ark-100vh、--ark-alignwide_ex_width、--ark-menulist_border、--ark-nav-padding--R、--ark-nav-padding--Y、--ark-nav_fz、--ark-gap--container、--ark-width--article、--ark-color--header_bg、--ark-color--header_txt、--ark-editor-100vw、--ark-article_width、--ark-color--border--table、--ark-color--gray--hover、--ark-color--link、--ark-color_border、--ark-font_family、--ark-fz--huge、--ark-fz--m、--ark-fz--n、--ark-fz--xl、--ark-fz--xs、--ark-fz--xxl、--ark-header_height--fixed、--ark-hover_gray、--ark-letter_spacing、--ark-list-padding、--ark-list-padding--has_bg、--ark-mt--h、--ark-mt--s、--ark-offset--y、--ark-opacity--thin、--ark-pad--container、--ark-scrollbar_width、--ark-submenu_btn_size、--ark-guide-offset

画面の区切りは、1000px以上がPC、600px以上1000px未満がタブレット、600px未満がスマートフォンです。

ユーティリティクラス(58種)

ブロックの「追加CSSクラス」に書くだけで効くクラスです。

CSSを書かずに、表示の切り替えや余白の調整ができます。

用途クラス
表示の切り替えu-display-block、u-display-none、u-hide-pc、u-hide-sp、u-only-pc、u-only-sp
余白u-mb-0、u-mb-10、u-mb-15、u-mb-20、u-mb-25、u-mb-30、u-mb-40、u-mb-5、u-mb-50、u-mb-60、u-mb-80、u-mt-0、u-mt-10、u-mt-15、u-mt-20、u-mt-25、u-mt-30、u-mt-40、u-mt-5、u-mt-50、u-mt-60、u-mt-80
文字u-color-thin、u-fw-bold、u-fw-lighter、u-fw-normal、u-fz-l、u-fz-m、u-fz-n、u-fz-s、u-fz-xl、u-fz-xs、u-fz-xxl、u-lh-10、u-lh-12、u-lh-14、u-lh-15、u-lh-16、u-lh-18、u-lh-20、u-ta-c、u-ta-l、u-ta-r
その他u-cf、u-cf--after、u-flex、u-flex--aic、u-flex--aicw、u-flex--c、u-fullheight、u-obf-contain、u-obf-cover

Arkhe Blocks と Arkhe Blocks Pro

ブロックは、テーマ本体ではなくこのプラグインが追加します。

接頭辞はすべて arkhe-blocks/ です。

無料版のコードには、Pro版だけのブロックも含めて34種の名前が並んでいます。

Pro版でないと登録されないものと、テーマがArkheでないと登録されないものに、印が付いています。

ブロック一覧(34種)

ブロック名表示名使える条件
arkhe-blocks/accordionアコーディオン無料版から
arkhe-blocks/accordion-itemアコーディオンの項目無料版から
arkhe-blocks/blog-cardブログカード無料版から
arkhe-blocks/box-linksボックスリンクPro版
arkhe-blocks/box-linkボックスリンクの項目Pro版
arkhe-blocks/buttonsボタン(まとめ)無料版から
arkhe-blocks/buttonボタン無料版から
arkhe-blocks/columnsリッチカラム無料版から
arkhe-blocks/columnカラム無料版から
arkhe-blocks/containerコンテナ無料版から
arkhe-blocks/custom-codeカスタムコード無料版から
arkhe-blocks/faqQ&A無料版から
arkhe-blocks/faq-itemQ&Aの項目無料版から
arkhe-blocks/dl説明リスト無料版から
arkhe-blocks/dl-dt用語無料版から
arkhe-blocks/dl-dd説明無料版から
arkhe-blocks/dl-div横並びの組無料版から
arkhe-blocks/iconアイコン無料版から
arkhe-blocks/notice通知無料版から
arkhe-blocks/sectionセクション無料版から
arkhe-blocks/section-headingセクション見出し無料版から
arkhe-blocks/stepステップ無料版から
arkhe-blocks/step-itemステップの項目無料版から
arkhe-blocks/tabタブ無料版から
arkhe-blocks/tab-bodyタブの中身無料版から
arkhe-blocks/timelineタイムライン無料版から
arkhe-blocks/timeline-itemタイムラインの項目無料版から
arkhe-blocks/toc目次無料版から
arkhe-blocks/sliderスライダーPro版
arkhe-blocks/slider-itemスライドPro版
arkhe-blocks/restricted-area制限エリアPro版
arkhe-blocks/page-list固定ページリストPro版+テーマがArkhe
arkhe-blocks/post-list投稿リストPro版+テーマがArkhe
arkhe-blocks/rssRSSPro版+テーマがArkhe

無料版で使えるブロックにも、一部の設定がPro版だけのものがあります。

公式の比較表では、通知・セクション・タブ・ステップ・タイムライン・ブログカード・リッチカラムがそれに当たります。

親の中でしか使えないブロック

次の組み合わせは、親ブロックの中にしか置けません。

AIに書かせるときは、この親子関係を先に渡さないと入れ子が壊れます。

親中に入れるもの
arkhe-blocks/accordionarkhe-blocks/accordion-item
arkhe-blocks/buttonsarkhe-blocks/button
arkhe-blocks/columnsarkhe-blocks/column
arkhe-blocks/dlarkhe-blocks/dl-dt、arkhe-blocks/dl-dd、arkhe-blocks/dl-div
arkhe-blocks/dl-divarkhe-blocks/dl-dt、arkhe-blocks/dl-dd
arkhe-blocks/faqarkhe-blocks/faq-item
arkhe-blocks/steparkhe-blocks/step-item
arkhe-blocks/tabarkhe-blocks/tab-body
arkhe-blocks/timelinearkhe-blocks/timeline-item
arkhe-blocks/box-linksarkhe-blocks/box-link
arkhe-blocks/sliderarkhe-blocks/slider-item

Q&Aの項目の block.json は、親の欄が自分自身(arkhe-blocks/faq-item)になっています。

機械的に親を読み取ると取り違えるので、arkhe-blocks/faq の中に置くと覚えておいてください。

コアブロックに足されるスタイル

WordPress標準のブロックにも、スタイルが追加されます。

ブロックの「スタイル」欄から選べ、クラス名は is-style- に続く名前です。

ブロックスタイル名
core/image、core/videoark-media-shadow、ark-media-border、ark-media-frame(影・枠線・フレーム)
core/listark-list-icon--dot、ark-list-icon--caret、ark-list-icon--check、ark-list-icon--circle、ark-list-icon--triangle、ark-list-icon--x、ark-list-icon--question、ark-list-numbered、ark-list-note
core/media-textark-card(カード型)
core/quotelarge(大きい引用)

Pro版では、コアブロックのツールバーに「ブロックの上の余白」を決めるボタンも足されます。

こちらはテーマがArkheのときだけ使えます。

カスタム書式(Pro版)

文字の一部に付ける書式です。

ツールバーからまとめて呼び出せます。

書式の名前中身
arkhe-blocks/markerマーカー
arkhe-blocks/font-size文字サイズ
arkhe-blocks/letter-spacing字間
arkhe-blocks/inline-icon文中のアイコン
arkhe-blocks/mini-note注釈
arkhe-blocks/clear書式の解除
arkhe-blocks/custom-{スラッグ}設定画面で自分で作った書式

フィルターと設定の保存先

  • arkb_blogcard__cache_time
  • arkb_blogcard__excerpt_length
  • arkb_blogcard__name_length
  • arkb_blogcard__title_length
  • arkb_scroll_hint
  • arkb_section__media_html
  • arkb_toc__ignore_classes
  • arkhe_blocks_custom_formats
  • arkhe_blocks_part__{パス}
  • arkhe_blocks_part_path__{パス}

ブログカードの文字数やキャッシュ時間、目次から外すクラスなどを変えられます。

Pro版には、ボックスリンク・スライダー・RSSのフックも加わります。

保存先(オプション名)中身
arkhe_blocks_general全般(コア拡張・書式の停止、パレットの色など)
arkhe_blocks_format書式(マーカーの色や形、カスタム書式)
arkhe_blocks_blockブロック(目次の見出し階層、ボタンの既定の色など)
arkhe_licence_keyライセンスキー(テーマ本体と共通)

設定の書き出しと読み込みは、REST APIの wp/v2/arkhe-blocks-settings-export、wp/v2/arkhe-blocks-settings-import、wp/v2/arkhe-blocks-settings-import-check で行われています。

CSS変数は --arkb- で始まり、57種あります。

余白・カラム幅・ボタンの角丸などを、ブロックの外から上書きできます。

Arkhe Toolkit

テーマ本体に入っていない、サイト運営向けの機能をまとめたプラグインです。

最新版は1.11です。

機能は、公式の機能説明と更新情報をもとに整理しています。

表の「追加された版」が空欄のものは、早い版からある機能です。

機能中身追加された版
パーツキャッシュヘッダー・フッター・サイドバーのHTMLを保存して使い回す
ドロワーメニュー開き方を選べる
シェアボタン表示位置とSNSの種類を選べる
ウィジェットエリアの追加記事の上下、固定ページの上下、ブログページの上下、追尾サイドバー
フッター前ウィジェットフッターの直前に置ける1.8
画像の拡大表示クリックで画像を拡大
遅延読み込み画像・動画・iframe設定は1.6
スクリプトの遅延読み込み指定したJSを後から読む1.7
ページ遷移の高速化リンク先を先読みする1.11で調整
空のpタグの除去本文の空段落を消す
構造化データ記事とパンくずのJSON-LDを出す
記事ごとのコードhead内と、body閉じタグ前1.8
コア機能の停止12項目(下の表)

ショートコード(6種)

ショートコード出すもの追加された版
[[reuse_block id="100"]]再利用ブロック(パターン)
[pcbr]、[spbr]PCだけ・スマホだけの改行
[icon class="…"]アイコンの <i> タグ
[[ark_svg アイコン名]]テーマとToolkitのSVGアイコン1.7
[html]] ~ [[/html]中身をHTMLとして出す1.9

記事ごとの設定(12種)

投稿・固定ページ・カテゴリーやタグの編集画面に、Arkheの設定欄が足されます。

保存先のメタキーは ark_meta_ で始まります。

メタキー中身
ark_meta_show_thumbアイキャッチを出すか
ark_meta_show_author著者情報を出すか
ark_meta_show_related関連記事を出すか
ark_meta_show_sidebarサイドバーを出すか(ターム)
ark_meta_hide_widget_top上部ウィジェットを隠すか
ark_meta_hide_widget_bottom下部ウィジェットを隠すか
ark_meta_subttlサブタイトル(固定ページ)
ark_meta_ttlbgタイトルの背景画像(固定ページ)
ark_meta_ttlposタイトルの位置(固定ページ)
ark_meta_show_excerpt抜粋を出すか(固定ページ)
ark_meta_show_desc説明を出すか(ターム)
ark_meta_list_type投稿リストの型(ターム)

1.7でシェアボタンを隠す項目が、1.8で記事ごとのコード欄が加わっています。

1.8以降は、カスタム投稿タイプにもこの設定欄が出ます。

停止できるWordPressの機能(12項目)

止めるもの初期値
WordPressのバージョン表記停止
絵文字用のスクリプト停止
コアのブロックパターン動く
rel=prev/next の出力動く
Windows Live Writer 連携動く
EditURI(RSD)動く
セルフピンバック動く
コアのサイトマップ動く
REST API の link タグ動く
srcset の出力動く
記号の自動変換(wptexturize)動く
RSSフィードのリンク動く

フックと保存先

Toolkitのフックは arkhe_toolkit_ で始まります。

一つずつの名前と使い方は、Arkhe│アクションフック・フィルターフック全まとめに載せています。

1.8で arkhe_toolkit_side_meta_screens と arkhe_toolkit_code_meta_screens が加わり、設定欄を出す投稿タイプを変えられるようになりました。

1.9では、一部のフック名の綴りが arkhe_toolit_ から arkhe_toolkit_ に直されています。

古い名前で書いたコードは、更新後に効かなくなるので確かめてください。

保存先(オプション名)中身
arkhe_toolkit_customizerカスタマイザーに足された項目
arkhe_toolkit_extension拡張機能のオン・オフ
arkhe_toolkit_cacheパーツキャッシュ
arkhe_toolkit_codeサイト全体のコード
arkhe_toolkit_remove停止する機能

Arkhe CSS Editor

管理画面でCSSを書けるようにするプラグインです。

CSSは、フロントだけ・エディターだけ・両方の3か所に分けて書けます。

当方は、このプラグインをSWELLのサイトでも使っています。

テーマがArkheでなくても動きます。

保存先(オプション名)中身REST API
arkhe_css_common両方で読むCSS読み書きできる
arkhe_css_frontフロントだけで読むCSS読み書きできる
arkhe_css_editorエディターだけで読むCSS読み書きできる
arkhe_css_settingsエディターの設定読み書きできる
arkhe_css_optionsその他の設定読み書きできる

CSSの3つは /wp-json/wp/v2/settings に出ているので、管理画面を開かずに書き換えられます。

全文を上書きする形なので、取得してから追記して送ってください。

記事ごとのCSSは、メタキー arkhe_css_editor_meta に入ります。

カスタム投稿タイプにも欄を出すには arkhe_css_editor_meta_screen を使います。

// 「お知らせ」の投稿タイプにも、記事ごとのCSS欄を出す
add_filter( 'arkhe_css_editor_meta_screen', function ( $screens ) {
	$screens[] = 'news';
	return $screens;
} );

1.2でツールバーにCSS Editorへのリンクが付き、1.2.2からはライセンス認証なしで管理画面から更新できるようになりました。

Arkhe Wookit

WooCommerceの商品ページやブロックの見た目を、Arkheに合わせるプラグインです。

Pro Packには含まれず、単体の買い切りで販売されています。

ここは公式の説明をもとに整理しています。

種類名前中身
ウィジェットエリアWooCommerce専用サイドバーショップのページだけに出すサイドバー
フィルターarkhe_wookit_add_to_cart_textカートに入れるボタンの文言
CSS変数--ark-woo-color--price価格の色
CSS変数--ark-woo-color--price--saleセール価格の色
CSS変数--ark-woo-color--starレビューの星の色
CSS変数--ark-woo-onsale--bg「セール」表示の背景色
CSS変数--ark-woo-btn-primary--bg重要なボタンの背景色
CSS変数--ark-woo-btn--paddingボタンの内側の余白
CSS変数--ark-woo-fz--grid商品一覧の文字サイズ
CSS変数--ark-woo-fz--grid_product商品リスト系ブロックの文字サイズ
CSS変数--ark-woo-mb--items商品リスト系ブロックの項目の間隔

SWELLと比べたときの違い

同じ作者のテーマなので、AIが2つを混同しやすくなっています。

違いが大きいところだけ並べます。

項目ArkheSWELL
ブロックの接頭辞arkhe-blocks/loos/
ブロックの置き場所別のプラグインテーマ本体
アクションフック55種4種
テーマ設定71項目538項目
設定の読み出しArkhe::get_setting()SWELL_Theme::get_setting()
部品の読み込みArkhe::get_part()SWELL_Theme::get_parts()
CSS変数の接頭辞--ark-、--arkb---swl-
記事ごとの設定ark_meta_(Toolkit)swell_meta_

SWELLの一覧は、SWELL│テーマ全機能リファレンスにまとめています。

AIに渡すときの書き方

そのまま貼るより、入っているプラグインと、何をしたいかを一緒に渡すほうが外しません。

当方が使っている頼み方です。

前提:WordPressテーマ Arkhe 3.14(SWELLではない)
入っているプラグイン:Arkhe Blocks Pro / Arkhe Toolkit / Arkhe CSS Editor
  ※入っていないものは前提にしないこと
ブロックの接頭辞は arkhe-blocks/ (例:arkhe-blocks/notice, arkhe-blocks/step)
親子のあるブロック:
  arkhe-blocks/accordion → arkhe-blocks/accordion-item
  arkhe-blocks/buttons → arkhe-blocks/button
  arkhe-blocks/columns → arkhe-blocks/column
  arkhe-blocks/dl → arkhe-blocks/dl-dt, arkhe-blocks/dl-dd, arkhe-blocks/dl-div
  arkhe-blocks/faq → arkhe-blocks/faq-item
  arkhe-blocks/step → arkhe-blocks/step-item
  arkhe-blocks/tab → arkhe-blocks/tab-body
  arkhe-blocks/timeline → arkhe-blocks/timeline-item
  arkhe-blocks/box-links → arkhe-blocks/box-link
  arkhe-blocks/slider → arkhe-blocks/slider-item
設定の読み出し:Arkhe::get_setting( 'キー' )
部品の読み込み:Arkhe::get_part( 'single/foot/related_posts' )
部品ごとのフック:arkhe_pre_get_part__{部品} / arkhe_part_path__{部品} / arkhe_part__{部品}
フックの接頭辞:arkhe_ (Toolkitは arkhe_toolkit_、Blocksは arkb_)
CSS変数:--ark-(テーマ)、--arkb-(ブロック)

やりたいこと:(ここに書く)

「SWELLではない」と書いておくのが効きます。

書かないと、loos/ のブロックや swell_ のフックが混ざって返ってきます。

この記事の数え方

無料で配布されているものは、配布ファイルを展開して機械で数えました。

有料のプラグインは、公式サイトの機能説明と更新情報をもとに整理しています。

製品版もとにしたもの
Arkhe3.14.0WordPress.org の配布ファイル
Arkhe Blocks2.27.1WordPress.org の配布ファイル
Arkhe Blocks Pro2.30公式の機能説明と更新情報
Arkhe Toolkit1.11公式の機能説明と更新情報
Arkhe CSS Editor1.2.2公式の機能説明と更新情報、当方での運用
Arkhe Wookit—公式の機能説明
  • フックは do_action と apply_filters の呼び出しから数えました。部品ごとに名前が変わるものは、1種として数えています
  • 同梱の更新確認ライブラリのフックは除いています(テーマの機能ではないため)
  • テーマ設定は、初期値の一覧にある項目を数えました
  • ブロックは、Arkhe Blocksの中にあるブロックの一覧から数えました。Pro版だけのものも含みます
  • WordPress本体のフックを、テーマが呼び直しているものは数えていません

フックの数は、数え方によって変わります。

部品ごとのフックを部品の数だけ数えると、何百にもなります。

バージョンが上がると増減しますので、使うときはお手元の版を確かめてください。

まとめ

Arkheは、テーマ本体にアクションフックが55種あり、差し込み口の多いテーマです。

ブロックはArkhe Blocks、運営向けの機能はToolkitと、機能がプラグインに分かれています。

AIに書かせるときは、入っているプラグインと、ブロックの親子関係を先に渡すと外しません。

フックを一つずつ使うときは、Arkhe│アクションフック・フィルターフック全まとめもあわせてご覧ください。

この記事で紹介しているコードは、GitHubのMOTOKI-LLC/WAZA-codeにもまとめています。

設定の上書きを試す例

次のPHPはArkheの子テーマのfunctions.phpのPHP領域、またはCode SnippetsのPHPスニペットのどちらか一方へ追加します。通常投稿の個別ページだけでサイドバー設定を変更します。親テーマへは書きません。既存の設定値をデータベースへ保存する処理ではありません。

add_action( 'wp', function () {
    if ( ! class_exists( 'Arkhe' ) || ! is_singular( 'post' ) ) {
        return;
    }
    // 設定を読み込んでから、このリクエストだけ変更する。
    Arkhe::get_setting();
    Arkhe::overwrite_setting( 'show_sidebar_post', false );
} );

公式配布テーマのget_setting・overwrite_settingを照合した例です。実サイトへの適用前に検証環境で通常投稿・固定ページ・一覧をPCとスマホで確認してください。記事ごとの設定や関連プラグインが表示に影響する場合があります。元に戻すときは追加した処理を削除するか、該当スニペットを無効にします。全プラグイン構成での表示確認は未実施です。

  • URLをコピーしました!

実装を任せたい方へ

WordPressのカスタマイズ代行

ブロックの追加、テーマの改修、管理画面の調整など、記事で紹介している内容の実装を承ります。1時間 ¥8,000〜(税込)。

WAZAの有料記事のサブスクリプションも開始しました。

サービス

Service

WordPressサイトのカスタマイズのサービスに関心がありましたら、ぜひ詳細をご覧ください。

目次