# Affiliate Quick Link Shortcode for DMM 日本語ガイド

このプラグインは、DMM アフィリエイト API を利用して、ショートコードによりアダルト動画やオークション作品などの画像・動画・リンクを簡単に埋め込み表示できる軽量プラグインです。

## 🔧 基本機能

- `[quick_link_dmm]` ショートコードで画像や動画リンク、または URL のみを生成
- `cid="..."`（品番）を指定してアダルト動画作品を表示
- `aid="..."`（オークション ID）を指定して DMM オークションページへのリンクを生成
- `size="small"` または `size="video"` で出力タイプを切り替え（デフォルトは画像大）
- `aff="xxxx"` でアフィリエイト ID を個別に指定可能（省略時は `lab888-001`）
- `link_only="1"` または `link_only="wp"` でプレーンなリンク URL を出力（ブログカード対策済）

## 🧩 ショートコードの使い方

### 基本

```
[quick_link_dmm cid="1dandy00914a"]
```

### 小画像で表示

```
[quick_link_dmm cid="1dandy00914a" size="small"]
```

### サンプル動画で埋め込み

```
[quick_link_dmm cid="1dandy00914a" size="video"]
```

### アフィリエイト ID を指定

```
[quick_link_dmm cid="1dandy00914a" aff="lab888-999"]
```

### オークションリンクを生成

```
[quick_link_dmm aid="2011464"]
```

### URL のみ出力（自動リンクされる）

```
[quick_link_dmm aid="2011464" link_only="1"]
```

### URL のみ出力（!を付加してブログカード無効化）

```
[quick_link_dmm aid="2011464" link_only="wp"]
```

## 📥 インストール手順

1. このプラグインフォルダ `affiliate-quick-link-dmm` を `/wp-content/plugins/` にアップロード
2. WordPress 管理画面で「プラグイン > Affiliate Quick Link Shortcode for DMM」を有効化
3. 「設定 > Quick Link DMM」で API ID を入力して保存

## ❗ 注意事項

- このプラグインは [DMM アフィリエイト API](https://affiliate.dmm.com/api/) の利用登録が必要です
- API リクエスト時には `lab888-990〜999` の ID を使用してください（DMM 側で自動割当）
- 表示リンクには `lab888-001` が使用されますが、ショートコード引数で変更可能です
- 表示される画像やタイトルは DMM の API から取得されます（キャッシュなし）

## 💬 クレジット表示

> 本サービスは [DMM Web サービス](https://affiliate.dmm.com/) を利用しています。

## 📜 ライセンス

GPL v2 またはそれ以降

---

© TROK Inc.

## 🆕 v1.4.1 での主な新機能

- フローティングバナーの表示タイミングを `show_at`（スクロール%）・`delay`（秒）で柔軟に指定可能
- `show_at="0"` でページロード後 `delay` 秒のみで表示できる仕様に
- z-indexを任意に調整可能（サイドメニューの上・モーダルの下など細かい重なり順制御）
- バナー要素をbody直下に移動し、重なりコンテキスト問題を根本解決
- バナーの初期状態・表示/非表示制御を外部JS（floating-banner.js）に一本化
- マウスオーバーで拡大＆不透明化、閉じるボタン、レスポンシブ対応

## 🧩 フローティングバナーの使い方

```
[quick_link_dmm cid="1dandy00463" size="floating" show_at="10" delay="3"]
```
- `show_at` : ページ全体の何%スクロールで表示待機状態にするか（0でスクロール無視）
- `delay`   : スクロール停止後、何秒後に表示するか（`show_at=0`時はページロード後の秒数）
- `z-index` : PHP/JSで直接調整可能（デフォルト2250、必要に応じて変更）

## 例
- `[quick_link_dmm cid="1dandy00463" size="floating"]`（デフォルト: 20%スクロール+2秒後表示）
- `[quick_link_dmm cid="1dandy00463" size="floating" show_at="0" delay="5"]`（ページロード5秒後に表示）
- `[quick_link_dmm cid="1dandy00463" size="floating" show_at="30" delay="1"]`（30%スクロール+1秒後表示）