# 拡張機能

WCPOSは、POSレジに新しい機能を追加する拡張機能をサポートしています。拡張機能ディレクトリでは、利用可能な拡張機能の閲覧、POS設定から直接インストール、およびアップデートの管理が可能です。

Pro機能

拡張機能のインストールと管理には[WCPOS Pro](/ja/getting-started/pro-license.md)が必要です。無料版では拡張機能カタログは表示されますが、インストールおよび有効化の操作は無効になっています。

## 利用可能な拡張機能[​](#available-extensions "利用可能な拡張機能への直接リンク")

### 決済ゲートウェイ[​](#payment-gateways "決済ゲートウェイへの直接リンク")

対面POS向けに設計されたカスタム決済ゲートウェイです。

[JA: Stripe TerminalJA: Stripe Terminalハードウェア（S700、WisePOS E）による対面カード決済。MOTOおよびシミュレーターモードに対応。](/ja/payment/gateways/stripe-terminal.md)

[JA: SumUp TerminalJA: SumUpカードリーダーによるカード決済に対応します。](/ja/payment/gateways/sumup-terminal.md)

[JA: Vipps MobilePayJA: QRコードまたはプッシュ通知によるスマートフォン決済。Vipps（ノルウェー）、MobilePay（デンマーク、フィンランド）。](/ja/payment/gateways/vipps-mobilepay.md)

[メール請求書顧客にオンライン決済用のリンクをメールで送信します。](/ja/payment/gateways/email-invoice.md)

独自のゲートウェイを構築しますか？[ゲートウェイテンプレート](/ja/reference/gateway-template.md)を参考にするか、[カスタムゲートウェイの概要](/ja/payment/gateways/.md)で全一覧をご確認ください。

### 多言語対応[​](#multilingual "多言語対応への直接リンク")

POS商品を言語でフィルタリングし、翻訳による重複がレジ検索やカタロググリッドに表示されないようにします。

[JA: WCPOS PolylangJA: Polylang連携 — WCPOS Proの言語対応商品同期と店舗ごとの言語選択。](/ja/extensions/polylang.md)

[JA: WCPOS WPMLJA: WPML連携 — POS商品を単一言語にフィルタリングします。](/ja/extensions/wpml.md)

[JA: WCPOS WP MultilangJA: WP Multilang連携 — POS商品を単一言語にフィルタリングします。](/ja/extensions/wp-multilang.md)

### クーポンとストアクレジット[​](#coupons-and-store-credit "クーポンとストアクレジットへの直接リンク")

[JA: WCPOS StoreApps Smart CouponsJA: StoreApps Smart CouponsのストアクレジットをWCPOSで利用できます。レシートへの残高表示と注文メモによる監査履歴に対応しています。](/ja/extensions/storeapps-smart-coupons.md)

### 在庫管理[​](#inventory "在庫管理への直接リンク")

[JA: WCPOS ATUM連携JA: WCPOS Proの店舗をATUM Multi-Inventoryのロケーションに紐付け、ロケーションごとの在庫数・価格・SKUを管理できます。](/ja/extensions/atum.md)

## 拡張機能の閲覧[​](#browsing-extensions "拡張機能の閲覧への直接リンク")

拡張機能ディレクトリは`POS Settings > 拡張機能`から開きます（バージョンによっては**プラグイン**と表示されます）。

ディレクトリには利用可能な拡張機能がカードグリッドで表示されます。各カードには以下の情報が表示されます：

* **アイコン**（拡張機能がアイコンを提供していない場合はパズルピースのフォールバック）
* **名前とバージョン**
* **説明**
* **カテゴリバッジ**
* **ステータス** — 有効、無効、更新あり、または未インストール

### フィルタリングと検索[​](#filtering-and-search "フィルタリングと検索への直接リンク")

上部の**カテゴリピルボタン**を使用して、カテゴリ別に拡張機能をフィルタリングできます。また、**検索フィールド**を使用して、名前、説明、またはタグで拡張機能を検索できます。

## 拡張機能のインストール[​](#installing-an-extension "拡張機能のインストールへの直接リンク")

1. `POS Settings > 拡張機能` を開きます。
2. 目的の拡張機能を見つけて、**インストール**をクリックします。
3. 拡張機能は WordPress のプラグインインストーラーを使用してダウンロードおよびインストールされます。
4. インストールが完了したら、**有効化**をクリックして有効にします。

内部的には、WCPOSはWordPressネイティブの`Plugin_Upgrader`を使用してインストールを処理するため、拡張機能は通常のWordPressプラグインと同じプロセスに従います。

## 有効化と無効化[​](#activating-and-deactivating "有効化と無効化への直接リンク")

インストール済みの各拡張機能のカードには、**有効化**ボタンと**無効化**ボタンがあります。

* **有効化**すると、拡張機能がPOSで動作するようになります。
* **無効化**すると、アンインストールせずに拡張機能を無効にします。拡張機能のファイルはサーバー上に残り、いつでも再有効化できます。

## 拡張機能の更新[​](#updating-extensions "拡張機能の更新への直接リンク")

インストール済みの拡張機能に新しいバージョンがある場合、カードに**更新あり**バッジと**更新**ボタンが表示されます。

### 自動更新[​](#auto-updates "自動更新への直接リンク")

ディレクトリからインストールされた拡張機能は、**デフォルトで自動更新が有効**になっています。ディレクトリ内の各拡張機能のカードから、自動更新のオン・オフを切り替えることができます。自動更新がオンの場合、WordPressは自動更新が有効なプラグインと同様に、新しいバージョンを自動的に適用します。

## トラブルシューティング[​](#troubleshooting "トラブルシューティングへの直接リンク")

### ボタンに「Pro が必要です」と表示される[​](#requires-pro-message-on-buttons "ボタンに「Pro が必要です」と表示されるへの直接リンク")

無料版のWCPOSでは、インストール、有効化、更新ボタンが無効になっています。拡張機能を管理するには、[WCPOS Pro](/ja/getting-started/pro-license.md)にアップグレードしてください。

### 拡張機能のインストールに失敗する[​](#extension-fails-to-install "拡張機能のインストールに失敗するへの直接リンク")

* WordPressサーバーが `wp-content/plugins` ディレクトリへの書き込み権限を持っているか確認してください。
* サーバーが外部へのHTTPSリクエストを送信できるか確認してください（一部のホスティングでは外部ダウンロードがブロックされています）。
* `WP Admin > POS > サポート > ログ`でエラーの詳細を確認してください。

### インストール後に拡張機能が表示されない[​](#extension-not-appearing-after-install "インストール後に拡張機能が表示されないへの直接リンク")

* POSを更新してください — 拡張機能のリストは最大12時間キャッシュされます。
* 拡張機能が有効化されているか確認してください（インストール済みでも無効な拡張機能は動作しません）。

### カタログが読み込まれない[​](#catalog-not-loading "カタログが読み込まれないへの直接リンク")

拡張機能カタログはリモートソースから取得され、ローカルに12時間キャッシュされます。カタログが読み込まれない場合：

* サーバーのインターネット接続を確認してください。
* キャッシュの有効期限が切れた後に再試行するか、サーバーのトランジェントキャッシュをクリアしてください。

***

## 開発者向け[​](#for-developers "開発者向けへの直接リンク")

### POS エクステンションの作成[​](#creating-a-pos-extension "POS エクステンションの作成への直接リンク")

WCPOS エクステンションは、WCPOS のフックと API を通じて POS と連携する標準的な WordPress プラグインです。作成手順は以下のとおりです。

1. **WordPress プラグインから始める。** エクステンションには、WooCommerce や WordPress のプラグインと同様に、標準的なプラグインヘッダーとエントリファイルが必要です。
2. **WCPOS と連携する。** WCPOS が提供するフックとフィルターを使用して、POS インターフェースまたはバックエンドに機能を追加します。
3. **リリースを GitHub でホストする。** エクステンションディレクトリは GitHub Releases を使用してバージョンを管理し、アップデートを配信します。

### ディレクトリへの登録[​](#submitting-to-the-directory "ディレクトリへの登録への直接リンク")

エクステンションカタログは [`wcpos/extensions`](https://github.com/wcpos/extensions) GitHub リポジトリで管理されています。エクステンションを登録するには：

1. リポジトリの README でカタログの形式とメタデータの要件を確認してください。
2. プルリクエストを作成して、エクステンションのメタデータを `catalog.json` に追加してください。
3. マージされると、すべての WCPOS Pro ユーザーのディレクトリにエクステンションが表示されます。

### GitHub リリースの規則[​](#github-release-conventions "GitHub リリースの規則への直接リンク")

アップデートのライフサイクルは GitHub Releases に基づいています：

* セマンティックバージョニングを使用して**タグバージョンを作成**します（例：`v1.0.0`、`v1.2.3`）。
* リリースアセットとして**プラグインの zip ファイルを添付**します。これは、ユーザーがインストールまたはアップデートする際にダウンロードされるファイルです。
* ディレクトリが検出できるよう、**リリースを公開**します（ドラフトではなく）。

新しいリリースを公開すると、拡張機能をインストール済みのユーザーの拡張機能ディレクトリにアップデートが表示されます。自動アップデートが有効になっている場合は、自動的に適用されます。

カタログスキーマと提出プロセスの詳細については、[`wcpos/extensions`](https://github.com/wcpos/extensions) リポジトリを参照してください。