# Integration Notes - Affiliate Quick Link Shortcode for DMM

## ✅ Compatibility

### Works well with:

- Classic Editor
- Block Editor (Gutenberg)
- Most SEO plugins (Yoast, All in One SEO)
- Cocoon theme (ボタンショートコードとの併用実績あり)

### ⚠️ Potential Conflicts:

- Caching plugins (e.g., WP Super Cache, LiteSpeed Cache): use with care when implementing API caching
- Security plugins that block external API requests
- WordPress’s automatic embed (oEmbed) may interfere with plain URLs unless suppressed (see `link_only="wp"`)

---

## 🔧 Embedding with Theme Templates

To embed the shortcode directly in a PHP template:

```php
echo do_shortcode('[quick_link_dmm cid="1dandy00914a"]');

🧩 Developer Filters (Planned)
// Example filter hook (to be implemented)
add_filter('quick_link_dmm_output', function($html, $atts) {
    return '<div class="custom-wrapper">' . $html . '</div>';
}, 10, 2);

🔌 REST API Integration (Future)
A REST endpoint is planned to return JSON metadata for a given cid or aid.

See also: future_plan.md

---

✅ ダウンロードはこちら：
👉 [integration_notes.md をダウンロード](sandbox:/mnt/data/integration_notes.md)

次に取りかかるファイルがあればご指示ください。

---

## 🆕 v1.4.1以降のフローティングバナー連携・カスタマイズ

- フローティングバナーはbody直下に移動されるため、テーマや他プラグインの重なり順（z-index）と干渉しにくい
- z-indexはPHP/JS両方で調整可能。サイドメニューやモーダルのz-index値をF12で調べ、間の値に設定
- show_at/delayパラメータで表示タイミングを柔軟に制御可能
- 外部JS（floating-banner.js）が正しく読み込まれている必要あり
- テーマテンプレートで直接ショートコードを埋め込む場合も、body直下移動・z-index調整は有効
- 詳細はREADMEやchangelogも参照
```