# Affiliate Quick Link Shortcode for DMM

この WordPress プラグインは、DMM アフィリエイト API を利用して、ショートコードから簡単にアフィリエイトリンクを生成できる軽量ツールです。動画のサムネイル表示、サンプル動画の埋め込み、テキストリンクの生成などに対応しています。

---

## 🔧 主な機能

- `[quick_link_dmm]` ショートコードを使って、DMM アフィリエイトリンクを記事中に挿入
- `cid="..."` による動画作品の表示
- `aid="..."` によるオークションページリンクの表示
- `size="small"`, `large`, `video` に対応（デフォルト：large）
- `link_only="1"` → プレーン URL 出力（リンク化なし）
- `link_only="wp"` → 冒頭に `!` を付加し、WordPress のブログカード化を防止
- `aff="..."` でアフィリエイト ID を個別指定可能（省略時は `lab888-001`）
- alt 属性に作品タイトルが自動挿入され、SEO にも配慮

---

## 🆕 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 秒後表示）

---

## 🧩 使用例

```wordpress
[quick_link_dmm cid="1dandy00914a"]
[quick_link_dmm cid="1dandy00914a" size="small"]
[quick_link_dmm cid="1dandy00914a" size="video"]
[quick_link_dmm cid="1dandy00914a" link_only="1"]
[quick_link_dmm aid="2011464" link_only="wp"]
```

---

## 🛠 インストール方法

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

---

## 💬 クレジット表示

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

---

## 🪪 ライセンス

GPL v2 またはそれ以降  
(c) TROK Inc.