拡張機能
WCPOSは、POSレジに新しい機能を追加する拡張機能をサポートしています。拡張機能ディレクトリでは、利用可能な拡張機能の閲覧、POS設定から直接インストール、およびアップデートの管理が可能です。
拡張機能のインストールと管理にはWCPOS Proが必要です。無料版では拡張機能カタログは表示されますが、インストールおよび有効化の操作は無効になっています。
利用可能な拡張機能
決済ゲートウェイ
対面POS向けに設計されたカスタム決済ゲートウェイです。
独自のゲートウェイを構築しますか？ゲートウェイテンプレートを参考にするか、カスタムゲートウェイの概要で全一覧をご確認ください。
多言語対応
POS商品を言語でフィルタリングし、翻訳による重複がレジ検索やカタロググリッドに表示されないようにします。
クーポンとストアクレジット
在庫管理
拡張機能の閲覧
拡張機能ディレクトリはPOS Settings > 拡張機能から開きます（バージョンによってはプラグインと表示されます）。
ディレクトリには利用可能な拡張機能がカードグリッドで表示されます。各カードには以下の情報が表示されます：
- アイコン（拡張機能がアイコンを提供していない場合はパズルピースのフォールバック）
- 名前とバージョン
- 説明
- カテゴリバッジ
- ステータス — 有効、無効、更新あり、または未インストール
フィルタリングと検索
上部のカテゴリピルボタンを使用して、カテゴリ別に拡張機能をフィルタリングできます。また、検索フィールドを使用して、名前、説明、またはタグで拡張機能を検索できます。
拡張機能のインストール
POS Settings > 拡張機能を開きます。- 目的の拡張機能を見つけて、インストールをクリックします。
- 拡張機能は WordPress のプラグインインストーラーを使用してダウンロードおよびインストールされます。
- インストールが完了したら、有効化をクリックして有効にします。
内部的には、WCPOSはWordPressネイティブのPlugin_Upgraderを使用してインストールを処理するため、拡張機能は通常のWordPressプラグインと同じプロセスに従います。
有効化と無効化
インストール済みの各拡張機能のカードには、有効化ボタンと無効化ボタンがあります。
- 有効化すると、拡張機能がPOSで動作するようになります。
- 無効化すると、アンインストールせずに拡張機能を無効にします。拡張機能のファイルはサーバー上に残り、いつでも再有効化できます。
拡張機能の更新
インストール済みの拡張機能に新しいバージョンがある場合、カードに更新ありバッジと更新ボタンが表示されます。
自動更新
ディレクトリからインストールされた拡張機能は、デフォルトで自動更新が有効になっています。ディレクトリ内の各拡張機能のカードから、自動更新のオン・オフを切り替えることができます。自動更新がオンの場合、WordPressは自動更新が有効なプラグインと同様に、新しいバージョンを自動的に適用します。
トラブルシューティング
ボタンに「Pro が必要です」と表示される
無料版のWCPOSでは、インストール、有効化、更新ボタンが無効になっています。拡張機能を管理するには、WCPOS Proにアップグレードしてください。
拡張機能のインストールに失敗する
- WordPressサーバーが
wp-content/pluginsディレクトリへの書き込み権限を持っているか確認してください。 - サーバーが外部へのHTTPSリクエストを送信できるか確認してください（一部のホスティングでは外部ダウンロードがブロックされています）。
WP Admin > POS > サポート > ログでエラーの詳細を確認してください。
インストール後に拡張機能が表示されない
- POSを更新してください — 拡張機能のリストは最大12時間キャッシュされます。
- 拡張機能が有効化されているか確認してください（インストール済みでも無効な拡張機能は動作しません）。
カタログが読み込まれない
拡張機能カタログはリモートソースから取得され、ローカルに12時間キャッシュされます。カタログが読み込まれない場合：
- サーバーのインターネット接続を確認してください。
- キャッシュの有効期限が切れた後に再試行するか、サーバーのトランジェントキャッシュをクリアしてください。
開発者向け
POS エクステンションの作成
WCPOS エクステンションは、WCPOS のフックと API を通じて POS と連携する標準的な WordPress プラグインです。作成手順は以下のとおりです。
- WordPress プラグインから始める。 エクステンションには、WooCommerce や WordPress のプラグインと同様に、標準的なプラグインヘッダーとエントリファイルが必要です。
- WCPOS と連携する。 WCPOS が提供するフックとフィルターを使用して、POS インターフェースまたはバックエンドに機能を追加します。
- リリースを GitHub でホストする。 エクステンションディレクトリは GitHub Releases を使用してバージョンを管理し、アップデートを配信します。
ディレクトリへの登録
エクステンションカタログは wcpos/extensions GitHub リポジトリで管理されています。エクステンションを登録するには：
- リポジトリの README でカタログの形式とメタデータの要件を確認してください。
- プルリクエストを作成して、エクステンションのメタデータを
catalog.jsonに追加してください。 - マージされると、すべての WCPOS Pro ユーザーのディレクトリにエクステンションが表示されます。
GitHub リリースの規則
アップデートのライフサイクルは GitHub Releases に基づいています：
- セマンティックバージョニングを使用してタグバージョンを作成します（例：
v1.0.0、v1.2.3）。 - リリースアセットとしてプラグインの zip ファイルを添付します。これは、ユーザーがインストールまたはアップデートする際にダウンロードされるファイルです。
- ディレクトリが検出できるよう、リリースを公開します（ドラフトではなく）。
新しいリリースを公開すると、拡張機能をインストール済みのユーザーの拡張機能ディレクトリにアップデートが表示されます。自動アップデートが有効になっている場合は、自動的に適用されます。
カタログスキーマと提出プロセスの詳細については、wcpos/extensions リポジトリを参照してください。