Prestashop 1.7：カスタムモジュールで分類リンクを正しく取得して表示します

このチュートリアルは、Prestashop 1.7カスタムモジュールの分類リンクを取得して表示しようとするときに遭遇する「未定義のインデンジ：リンク」エラーを解決することを目的としています。 Prestashopのリンククラスを使用してリンクオブジェクトをバックエンドPHPコードのSmartyテンプレートに渡す方法を詳細に説明し、フロントエンドテンプレートのgetCategoryLinkメソッドを正しく呼び出して、リンクの正確性とアクセシビリティを確保するために[分類URL]を動的に生成します。

「未定義のインデックス：リンク」エラーの理解

Prestashop 1.7では、開発者がカスタムモジュールまたはテンプレートに分類リストを表示しようとすると、カテゴリ:: getNestedCategories（）メソッドを使用して分類データを取得できます。このメソッドは、分類ID、名前、書き換えURL（link_rewrite）などの情報を含むネストされた配列を返します。ただし、この配列には、分類の完全なURLを直接保存するための事前に生成されたリンクキーはありません。

Smartyテンプレートで{$ maincategory.link}に直接アクセスしようとすると、リンクキーがカテゴリ:: getNestedCategories（）で返される配列に存在しないため、Smartyは通知をスローします。これは、これらのカテゴリのURLを手動で生成する必要があることを意味します。

解決策：Prestashopのリンククラスを活用してください

Prestashopは、強力なリンククラス（$ this-> context-> link）を提供します。これは、ストア内のさまざまなURL（製品、カテゴリ、CMSページなどを含む）を生成するための標準かつ推奨される方法です。リンククラスを使用すると、生成されたURLがSEOフレンドリーであり、多言語、マルチストア、およびURL書き換えルールを正しく処理できます。

「未定義のインデックス：リンク」エラーを解決し、分類リンクを正しく生成するには、次の2つの手順を実行する必要があります。

1。バックエンドPHPコード：リンクオブジェクトをSmartyに渡します

PrestashopモジュールのPHPファイル（Hook MethodまたはRenderWidgetメソッドなど）では、$ this-> context-> linkオブジェクトをSmartyテンプレートに割り当てる必要があります。このようにして、Smartyテンプレートはリンククラスのメソッドにアクセスできます。

  context-> language-> id）;

//分類データとオブジェクトをSmartyにリンクします
$ this-> context-> smarty-> assile（array（
    「Allcategories」=> $ Allcategories、
    'link' => $ this-> context-> link、//キーステップ：リンクオブジェクトをSmartyに割り当てる
））;

//テンプレートをRELUNTER $ this-> fetch（ 'module：'。$ this-> name。 '/views/templates/widget/block.tpl'）;

// ...
？>

2。フロントエンドのSmartyテンプレート：リンクオブジェクトを使用してURLを生成します

.tplテンプレートファイルでは、phpで割り当てた{$ link}変数を介してリンクオブジェクトのメソッドにアクセスできるようになりました。 getCategoryLink（）メソッドを使用して、分類のIDと書き換えURLに基づいて完全な分類リンクを生成します。

 { * views/templates/widget/block.tpl *}

{foreach from = $ allcategories item = maincategory}
   {*メインカテゴリリンクを生成*}
   <a href="%7B%24%20link->%20getCategoryLink%EF%BC%88%24%20maincategory.id_category%E3%80%81%24%20maincategory.link_rewrite%EF%BC%89%7C%E3%82%A8%E3%82%B9%E3%82%B1%E3%83%BC%E3%83%97%EF%BC%9A%20'html'%EF%BC%9A%20'utf-8'%7D" title="{$ maincategory.name | Escape： 'htmlall'： 'utf-8'}">
       {$ maincategory.name | Escape： 'htmlall'： 'utf-8'}
   </a>

   { *トラバーサルサブクラス（存在する場合） *}
   {ISSET（$ maincategory.children）&&！empty（$ maincategory.children）}
       

{foreach from = $ maincategory.children item = subcategory}
• {$ subcategory.name | Escape： 'htmlall'： 'utf-8'}
{/foreach}

{/もし} {/foreach}

コード説明：

• $ link-> getCategoryLink（$ maincategory.id_category、$ maincategory.link_rewrite）：これがコアパーツです。リンクオブジェクトのgetCategoryLinkメソッドを呼び出し、現在の分類のID_Category（分類ID）とlink_rewrite（分類URL書き換え名）に渡されます。これらの2つのパラメーターは、分類されたURLを生成するために必要です。
• |エスケープ： 'HTML'： 'UTF-8'：これはSmartyのエスケープ修飾子です。潜在的なクロスサイトスクリプティング（XSS）攻撃を防ぐために、出力URL HTMLエンティティから脱出するために使用されます。この修飾子は、HTMLへのすべてのコンテンツ出力、特にリンクとテキストのコンテンツに強くお勧めします。
• | ESCAP： 'HTMLALL'： 'UTF-8'：より包括的なHTMLエスケープをタイトル属性または表示テキストに実行するために使用します。

完全な例とメモ

より完全なコンテキストを提供するために、上記のロジックを実装する方法を示す簡単なPrestashop 1.7モジュールの例を以下に示します。

モジュールPHPファイル（yourmodule.php）

  name = 'yourmodule';
        $ this-> tab = 'front_office_features';
        $ this-> version = '1.0.0';
        $ this-> author = 'your name';
        $ this-> need_instance = 0;
        $ this-> ps_versions_compliance = [
            'min' => '1.7'、
            'max' => _ps_version_、
        ];
        $ this-> bootstrap = true;

        親:: __ construct（）;

        $ this-> displayName = $ this-> l（ '私のカスタムカテゴリディスプレイモジュール'）;
        $ this-> description = $ this-> l（ '正しいリンクを持つカテゴリを表示します。'）;

        $ this-> cundileuninstall = $ this-> l（ 'アンインストールしたいですか？'）;
    }

    パブリック関数インストール（）
    {
        親を返す:: install（）&&
               $ this-> registerhook（ 'displayhome'）; //フックを登録します。たとえば、ホームページに表示}

    パブリック関数uninstall（）
    {
        return parent :: uninstall（）;
    }

    /**
     *モジュールコンテンツをレンダリングするためのフックメソッド* @param array $ params
     * @return文字列
     */
    パブリック関数hookdisplayhome（$ params）
    {
        // renderwidgetメソッドを呼び出してロジックを処理し、render $ this-> renderwidget（null、$ params）;
    }

    /**
     *モジュールコンテンツをレンダリングする実用的な方法* @Param String | null $ hookName
     * @param array $ configuration
     * @return文字列
     */
    パブリック関数renderwidget（$ hookname = null、array $ configuration = []）
    {
        //ネストされた構造を含むすべての分類データを取得$ allcategories = category :: getNestedCategories（null、$ this-> context-> language-> id）;

        //分類データとオブジェクトをSmartyにリンクします
        $ this-> context-> smarty-> assile（array（
            「Allcategories」=> $ Allcategories、
            'link' => $ this-> context-> link、// key：リンクオブジェクトをSmartyに割り当てる
        ））;

        //レンダリングモジュールのSMARTYテンプレートは$ this-> fetch（ 'module：'。$ this-> name。 '/views/templates/widget/block.tpl'）;
    }
}

モジュールSmartyテンプレートファイル（ビュー/テンプレート/ウィジェット/block.tpl）

 <div class="custom-category-list">
    <h2>すべてのカテゴリ</h2>
    <ul>
        {foreach from = $ allcategories item = maincategory}
            <li>
                <a href="%7B%24%20link->%20getCategoryLink%EF%BC%88%24%20maincategory.id_category%E3%80%81%24%20maincategory.link_rewrite%EF%BC%89%7C%E3%82%A8%E3%82%B9%E3%82%B1%E3%83%BC%E3%83%97%EF%BC%9A%20'html'%EF%BC%9A%20'utf-8'%7D" title="{$ maincategory.name | Escape： 'htmlall'： 'utf-8'}">
                    {$ maincategory.name | Escape： 'htmlall'： 'utf-8'}
                </a>

                {ISSET（$ maincategory.children）&&！empty（$ maincategory.children）}
                    <ul>
                        {foreach from = $ maincategory.children item = subcategory}
                            <li>
                                <a href="%7B%24%20link->%20getCategoryLink%EF%BC%88%24%20subcategory.id_category%E3%80%81%24%20subcategory.link_rewrite%EF%BC%89%7C%E3%82%A8%E3%82%B9%E3%82%B1%E3%83%BC%E3%83%97%EF%BC%9A%20'html'%EF%BC%9A%20'utf-8'%7D" title="{$ subcategory.name | escape： 'htmlall'： 'utf-8'}">
                                    {$ subcategory.name | Escape： 'htmlall'： 'utf-8'}
                                </a>
                            </li>
                        {/foreach}
                    </ul>
                {/もし}
            </li>
        {/foreach}
    </ul>
</div>

注：

• コンテキスト（$ this-> context）： prestashopモジュールでは、$ this->コンテキストは、ストア、言語、通貨、リンクなどの現在のコア情報へのアクセスを提供するグローバルオブジェクトです。モジュールの正しいコンテキストでアクセスしてください。
• パフォーマンスの考慮事項：カテゴリ:: getNestedCategoriesメソッドは、分類の数が膨大な場合、より多くのリソースを消費する場合があります。非常に大規模なWebサイトの場合、このモジュールが頻繁に呼ばれる場合、パフォーマンスを最適化するためにキャッシュメカニズムの導入を検討する必要がある場合があります。
• セキュリティ：常にコンテンツ出力をHTML（| Escape： 'HTML'： 'UTF-8'）にエスケープします。特にデータベースから読み取られるデータ、またはXSS（クロスサイトスクリプティング）攻撃を防ぐためにユーザーが入力します。これは、Web開発におけるベストプラクティスです。
• SEOフレンドリー：リンククラスを使用して生成されたURLは、Prestashopが推奨するSEOフレンドリーな方法です。リンクの正確性と検索エンジンのインデックス性を確保するために、URLの書き換えルール、多言語、およびマルチストアパスを自動的に処理します。

要約します

Prestashopカスタムモジュールの「未定義のインデックス：リンク」エラーを解くための鍵は、カテゴリ:: getNestedCategoriesメソッドで返されるデータ構造を理解することです。正しい方法は、Prestashopが提供するリンククラスを使用し、モジュールのPHPコードのSmartyテンプレートに割り当ててから、{$ link-> category.id_category、$ category.link_rewrite）}方法を使用して{$ link-> category.id_category）を使用してSmartyテンプレートの分類リンクを動的に生成することです。このアプローチに従って、エラーを解決するだけでなく、生成されたURLが安全でSEOフレンドリーで、Prestashopのベストプラクティスに準拠していることを保証します。

以上がPrestashop 1.7：カスタムモジュールで分類リンクを正しく取得して表示しますの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。