newsPro プラグイン

📖

マニュアル・設定方法

➔

### リッチな記事作成

- **Summernote Lite エディタ**搭載 – APIキー不要、インストール後すぐに利用可能
- エディタ内から直接**画像アップロード**・本文への挿入
- **サムネイル画像**設定で一覧ページの見栄えを大幅に強化
- サムネイル画像の**切り抜き(Cropper.js)**機能を標準搭載。

### 📂 3つのニュースタイプ

| タイプ | 用途 |
|--------|------|
| **内部記事** | Summernoteエディタでリッチテキスト本文を記述 |
| **外部リンク** | キャンペーンページや外部サイトへの誘導リンク |
| **ファイル配布** | PDF・カタログ・資料などをダウンロード提供 |

### 🗂️ カテゴリー管理

- 記事をカテゴリーで分類・一覧フィルタリング
- フロント画面にタブ形式でカテゴリー切り替えを表示
- **ドラッグ&ドロップ**でカテゴリの並び順を直感的に変更
- カテゴリごとの一覧ページ(`/news/category/{id}`)を自動生成
- カテゴリー単位の**表示/非表示**制御

### 🏷️ タグ管理

- 記事に複数のタグを設定可能(ManyToMany)
- フロント画面のサイドバーに**タグクラウド**を表示
- タグごとの一覧ページ(`/news/tag/{id}`)を自動生成
- 記事一覧・詳細ページにタグバッジを表示
- 登録時のタグ名重複チェック機能

### 📅 アーカイブ(年月別フィルター)

- サイドバーに**年月別アーカイブ**をアコーディオン形式で表示
- 年をクリックすると月一覧を展開、各月の**記事件数**付き
- `?year=YYYY&month=M` のURLパラメータで簡単に絞り込み
- フィルター中は**バッジ表示**とワンクリック**クリアボタン**
- カテゴリーページでもアーカイブフィルターを併用可能
- レスポンシブ対応(768px以下では1カラムに自動切替)

### 🔍 SEO対策

- **noindex設定** – 不要ページをGoogleインデックスから除外
- **メタディスクリプション** – ページごとに設定可能
- **パンくずリスト** – HTML表示 + Schema.org JSON-LD 構造化データ
- 構造化データによりGoogle検索結果の表示品質を最適化
- アーカイブフィルター時もパンくずリスト・JSON-LDに年月を反映

### 管理画面の効率化

- **Ajax 表示/非表示トグル** – バッジをクリックするだけで即時切替、ページリロード不要
- **記事複製** – 既存記事をワンクリックでコピーし、編集画面に即遷移
- **検索・絞り込みフォーム** – キーワード・カテゴリー・表示状態・ニュースタイプ・公開日(From/To)で高度な絞り込み
- 検索条件はセッションに保持、ページネーション時も維持
- 絞り込み中バッジと総件数を一覧上部に常時表示
- **公開予定バッジ** – 公開日時が未来の記事タイトル横に「公開予定」バッジを自動表示
- **CSVエクスポート / インポート** – 記事の一括登録やバックアップに対応。絞り込み状態を維持したCSVダウンロードが可能
- **管理者プレビュー** – 管理画面ログイン中はフロント画面で非公開・公開予定記事も確認可能(ページ上部に「プレビューモード」の警告バナーをわかりやすく表示)

### 一覧ページの説明文表示

- メタディスクリプション(または本文の抜粋)を一覧・ブロックにサマリーとして表示
- 記事の内容を一覧で把握でき、クリック率・ユーザビリティを向上

### 関連ニュース

- 詳細ページで同じカテゴリーのニュースを**最大4件自動表示**(画像左・説明文右の洗練された2カラムレイアウト)
- サイト内回遊率の向上とユーザーの滞在時間を改善

### 関連商品 (Related Products)

- 記事ごとにECサイト内の**商品を複数登録・紐付け**可能
- 登録は管理画面での**Ajaxサジェスト検索**に対応(商品名やIDで検索し即時追加)
- 登録した商品の表示順は**並び替え(↑/↓ボタン)**で直感的にコントロール可能
- フロント詳細ページに「この記事で紹介した商品」として価格・画像付きでグリッド表示し、商品詳細へ誘導(CVRの向上に直結)

### SNSシェアボタン (Social Share Buttons)

- 記事詳細ページに **X (Twitter)**, **Facebook**, **LINE** でのシェアボタンを表示
- **Copy Link (リンクコピー)機能**を搭載 – クリップボードへのURLコピーと成功をお知らせするツールチップ通知を装備
- ユーザーによる拡散を促し、サイトのアクセスアップと知名度向上に貢献

### 人気記事ランキング & 閲覧数カウント (Popular Posts & View Count)

- **自動閲覧数 (PV) カウント**: 記事詳細ページが閲覧されると自動的にカウントをインクリメント
- **多重カウント防止機能**: セッション単位でアクセスを記録し、同一ユーザーの連続F5リフレッシュによる意図しないPV水増しを防止
- **「人気記事ランキング」ブロック**:
- 管理画面のレイアウト管理からサイドバーなどにドラッグ&ドロップで配置可能
- ゴールド (1位), シルバー (2位), ブロンズ (3位), グレー (4, 5位) の視覚的に美しいランキングバッジを表示
- 記事サムネイル画像、タイトル、投稿日、および直感的な目のアイコン付きの閲覧数(👁 1,234)を表示
- ホバー時にカードが滑らかに浮き上がるインタラクティブなマイクロアニメーションを搭載

### RSS / Atom フィード自動生成

- URL `/news/feed.xml` で最新の公開記事(最大50件)をRSS 2.0形式で自動出力
- 各種RSSリーダー(Feedlyなど)での購読や外部サービスとの自動連携が可能
- メタ情報(店舗名等)の自動反映および記事サムネイル画像付きのフィード内容

### フロント画面のキーワード検索 & ページネーション改善

- フロント画面のサイドバーにキーワード検索窓(Search Box)を搭載し、タイトルと本文から相対検索可能
- ページネーション(Pager)を動的化し、検索キーワードや年月別、カテゴリー、タグなどの絞り込み条件を維持したままシームレスなページ遷移を実現

### レスポンシブデザイン

---

## フロント画面 URL一覧

| URL | 内容 |
|-----|------|
| `/news` | 新着情報一覧 |
| `/news/page/{pageno}` | 一覧ページネーション |
| `/news?year=YYYY` | 年別アーカイブ |
| `/news?year=YYYY&month=M` | 年月別アーカイブ |
| `/news/{id}` | 新着情報 詳細 |
| `/news/{id}/download` | ファイルダウンロード |
| `/news/category/{id}` | カテゴリー別一覧 |
| `/news/category/{id}?year=YYYY&month=M` | カテゴリー × 年月絞り込み |
| `/news/tag/{id}` | タグ別一覧 |
| `/news/tag/{id}/page/{pageno}` | タグ別一覧ページネーション |
| `/news/feed.xml` | RSSフィード (RSS 2.0) |

- **新着情報管理**: 管理画面から新着情報を登録・編集・削除できます
- **Ajax 表示/非表示トグル**: 一覧画面のバッジをクリックするだけで表示状態を即時切り替え(ページ遷移不要)
- **記事の複製**: 一覧画面の「複製」ボタンで記事を丸ごとコピーし、編集画面に遷移
- **カテゴリー管理**: カテゴリーを登録・編集・削除し、新着情報を分類できます
- カテゴリーも Ajax で表示/非表示を即時切り替え可能
- **CSVエクスポート / インポート**: 記事のバックアップや一括登録が可能
- **複数のニュースタイプ**:
- **内部タイプ**: Summernote Lite エディタで本文を記述
- **外部タイプ**: 外部 URL へのリンク
- **ファイルタイプ**: PDF などのファイルをアップロード
- **Summernote Lite エディタ統合**: API キー不要(jsDelivr CDN 経由)、日本語 UI
- エディタ内から直接画像をアップロードして本文に挿入可能
- **サムネイル画像**: 各新着情報にサムネイル画像を設定可能(magic byte 検証・5MB 上限・**WebP形式対応**)。Cropper.js によりアップロード前に好きな部分を 16:9 の比率で切り抜き可能。また画像のワンクリック削除にも対応。

1. 管理画面で「コンテンツ管理」→「新着情報管理」に移動
2. 「新規登録」ボタンをクリック
3. 以下の情報を入力:
- **公開日時**: 新着情報の公開日時(必須)
- **タイトル**: 新着情報のタイトル(必須)
- **サムネイル画像**: 表示用のサムネイル画像(オプション)
- **タイプ**: 内部/外部/ファイルから選択(必須)
- **本文/URL/ファイル**: 選択したタイプに応じたコンテンツ
- **SEO設定**: noindex、メタタグ、メタディスクリプション
4. 「登録」ボタンをクリック

プラグインを有効化すると、自動的に「newsPro」「newsProPopular」人気記事ランキングのブロックが作成されます。

1. 管理画面で「コンテンツ管理」→「レイアウト管理」に移動
2. レイアウトを編集
3. 「newsPro」また「newsProPopular」ブロックをドラッグ&ドロップで配置
4. ブロック設定で表示件数を設定(デフォルト: 3件)

| URL 　|　 内容 |
|-----|------|
| `/news` または `/news/page/{pageno}` | 新着情報一覧 |
| `/news?year=YYYY` | 年別アーカイブ |
| `/news?year=YYYY&month=M` | 年月別アーカイブ |
| `/news/{id}` | 新着情報詳細 |
| `/news/category/{id}` または `/news/category/{id}/page/{pageno}` | カテゴリー別一覧 |
| `/news/category/{id}?year=YYYY&month=M` | カテゴリー × 年月絞り込み |
| `/news/feed.xml` | RSSフィード (RSS 2.0) |

**内部タイプ**: リッチテキストエディタで本文を記述
**外部タイプ**: 外部URLへのリンク
**ファイルタイプ**: PDFなどのファイルをアップロード

- noindex設定
- メタタグ設定
- メタディスクリプション設定

バージョン1.3.5からのアップデート内容（1.3.6〜1.3.9）をご案内いたします。本アップデートでは、投稿編集ワークフローの改善、SEO対策の高度化、スライダーブロックの刷新、管理画面の機能拡張など、多岐にわたる機能追加と最適化を行いました。

■ 主なアップデート内容

【1】下書き保存とセキュアプレビュー機能（1.3.9）
・公開ステータスに「下書き（Draft）」を追加しました。
・下書き記事を安全に確認・共有できる、推測不可能な専用のプレビュー用URL（`/news/preview/{token}`）を自動生成する機能を実装しました。
・非公開（下書きまたは期限切れ）記事の添付ファイルへの直接ダウンロードアクセスを制限し、セキュリティを強化しました。

【2】掲載終了日時の設定（1.3.9）
・記事ごとに公開開始日時に加え、掲載終了日時（`end_date`）を設定できるようになりました。期限を過ぎった記事は自動的にフロント非表示、XMLサイトマップ除外、ダウンロードアクセス遮断が実行されます。

【3】高度なSEO対策とXMLサイトマップの自動統合（1.3.9）
・ニュース専用のXMLサイトマップ（`/sitemap_news.xml`）の動的生成を実装し、EC-CUBE本番の `/sitemap.xml` インデックスへ自動注入する機能を搭載しました。
・重複コンテンツ対策として、全ての新着情報フロントページ（一覧、カテゴリ、タグ、詳細等）に自己参照型の `<link rel="canonical">` タグを自動付与します。
・構造化データ `Schema.org (NewsArticle)` の記述をさらに最適化し、`publisher` および `mainEntityOfPage` を追加してGoogle推奨仕様に完全準拠しました。

【4】Splide.js 無限ループスライダーブロックの追加（1.3.9）
・従来のSwiperに代わり、超軽量・高性能な「Splide.js」を採用した無限ループ新着スライダーブロック（`newsProSlider`）を新たに同梱しました。管理画面のレイアウト管理から簡単に配置可能です。

【5】商品ショートコード機能（1.3.9）
・記事の本文中に `[product id=商品ID]` を記述するだけで、フロント画面で画像、価格、詳細リンク付きの美しい「商品カード（Product Card）」に自動変換されるTwigフィルターを実装しました。

【6】おすすめ（関連）記事レコメンドアルゴリズムの強化（1.3.9）
・関連記事の抽出順を「同一タグの重複度」→「同じカテゴリー」→「最新記事」の優先順位で自動で補完・動的取得するようロジックを最適化しました。関連記事のレイアウトも、ホバーエフェクト対応のモダンな3カラム縦型カードに刷新しています。

【7】人気記事ランキングの機能拡張（1.3.9 / 1.3.8）
・人気記事ブロック（`newsProPopular`）に集計範囲（全期間、過去7日間、過去30日間）の設定オプションを追加しました。
・極端に長いタイトルによるレイアウト崩れを防ぐため、ランキング表示時のタイトルに4行制限（line-clamp）を適用しました。

【8】管理画面の利便性向上（1.3.8 / 1.3.7）
・管理画面のカテゴリー一覧およびタグ一覧に、それぞれ紐づいている記事の「総件数」を表示する列を追加しました。
・複数記事を一括で「表示 / 非表示」に切り替える一括ステータス更新機能を追加しました。
・削除処理を実行した後に、検索キーワードや現在のページネーション位置（ページ番号）などのクエリパラメータを保持して元の画面にリダイレクトするよう改善しました。

【9】テキスト処理と文字化けの改善（1.3.8）
・新しいTwigフィルター `html_plain` を導入し、絵文字やHTMLエンティティがスライス時に途中で切れることによる文字化けを防止しました。
・プレーンテキスト抽出時に、`script` や `style` タグの中身（コード）が露出しないようクリーニング処理を徹底しました。

本バージョンへのアップデートにより、ショップ運営におけるお知らせ管理の運用効率化と、集客・SEO面での効果が大きく向上します。ぜひご活用ください。

【新機能・改善内容】
1. プラグイン設定画面の追加
管理画面から以下の項目を簡単にカスタマイズできるようになりました。
・記事一覧のレイアウト（リスト表示 / グリッド表示）
・ブロックのレイアウト（リスト表示 / グリッド表示）
・ブロックの表示件数（1〜20件）
・関連ニュースの最大表示数（0〜12件）
・SNSシェアボタン（X, Facebook, LINE, リンクコピー）の表示/非表示
・閲覧数（PV数）の表示/非表示（※同一ユーザーの重複カウント防止付き）

2. ピン留め機能（Sticky Post）
・重要なニュースを一覧やブロックの最上部に固定表示できるようになりました。
・固定された記事にはアイキャッチとして「HOT」バッジが自動付与されます。

3. カスタムURLスラグ機能
・新着情報ごとに任意のURL（例: /news/sale-campaign）を設定できるようになりました。日本語やマルチバイト文字のスラグにも対応し、SEO対策に最適です。

4. 公開・表示設定の拡張（会員限定公開）
・会員限定機能：ログイン中の会員のみが閲覧できるニュース記事を設定可能になりました。
・トップページ表示設定：各記事ごとに「トップページに表示するかどうか」を個別に設定できるようになりました。

- 管理画面の左メニュー「新着情報管理」配下に「新規登録」メニューを追加し、一覧メニュー名を「新着情報一覧」に整理
- NewsControllerのコンストラクタおよびプロパティから不要となったConfigRepositoryへの依存関係を削除
- データベースから plg_news_pro_config テーブルを削除
- 不要となったConfig関連ファイル（ConfigController、ConfigType、ConfigRepository、Config、config.twig）を完全削除
- メンバーの管理権限による新着情報削除制限の実装と型警告の修正