بارگذاری پیش‌دستانه (Speculative Loading)

سوالات متداول

چگونه می‌توانم از پیش‌واکشی و پیش‌رندر شدن URLهای خاص جلوگیری کنم؟

هر URLی را نمی‌توان به طور منطقی پیش‌رندر کرد. پیش‌رندر محتوای استاتیک معمولاً قابل اعتماد است، اما پیش‌رندر محتوای تعاملی، مانند URL خروج، می‌تواند منجر به مشکلاتی شود. به همین دلیل، برخی URLهای اصلی وردپرس مانند /wp-login.php و /wp-admin/* از پیش‌واکشی و پیش‌رندر مستثنی هستند. علاوه بر این، هر URL تولید شده با wp_nonce_url() (یا که حاوی متغیر کوئری _wpnonce باشد) و لینک‌های nofollow نیز نادیده گرفته می‌شوند. می‌توانید الگوهای URL اضافی را با استفاده از فیلتر plsr_speculation_rules_href_exclude_paths مستثنی کنید.

مثال زیر اطمینان می‌دهد که URLهایی مانند https://example.com/cart/ یا https://example.com/cart/foo از پیش‌واکشی و پیش‌رندر مستثنی هستند:

<?php
add_filter(
    'plsr_speculation_rules_href_exclude_paths',
    function ( array $exclude_paths ): array {
        $exclude_paths[] = '/cart/*';
        return $exclude_paths;
    }
);

به خاطر داشته باشید که گاهی اوقات ممکن است مفید باشد که یک URL را از پیش‌رندر مستثنی کنید در حالی که همچنان اجازه پیش‌واکشی آن را می‌دهید. برای مثال، صفحه‌ای با جاوا اسکریپت سمت کلاینت برای به‌روزرسانی وضعیت کاربر احتمالاً نباید پیش‌رندر شود، اما پیش‌واکشی آن منطقی خواهد بود.

برای این منظور، فیلتر plsr_speculation_rules_href_exclude_paths حالت فعلی (یا “prefetch” یا “prerender”) را دریافت می‌کند تا استثناهای شرطی را فراهم کند.

مثال زیر اطمینان می‌دهد که URLهایی مانند https://example.com/products/... نمی‌توانند پیش‌رندر شوند، در حالی که همچنان اجازه می‌دهد پیش‌واکشی شوند:

<?php
add_filter(
    'plsr_speculation_rules_href_exclude_paths',
    function ( array $exclude_paths, string $mode ): array {
        if ( 'prerender' === $mode ) {
            $exclude_paths[] = '/products/*';
        }
        return $exclude_paths;
    },
    10,
    2
);

همانطور که در بالا ذکر شد، افزودن کلاس CSS no-prerender به یک لینک مانع از پیش‌رندر شدن آن می‌شود (اما نه پیش‌واکشی). علاوه بر این، لینک‌های دارای rel=nofollow نه پیش‌واکشی می‌شوند و نه پیش‌رندر، زیرا برخی افزونه‌ها این مورد را به لینک‌های غیر idempotent (مانند افزودن به سبد خرید) اضافه می‌کنند؛ چنین لینک‌هایی در حالت ایده‌آل باید دکمه‌هایی باشند که درخواست POST را فعال می‌کنند یا حداقل باید از wp_nonce_url() استفاده کنند.

آیا ملاحظات خاصی برای رفتار بارگذاری پیش‌دستانه وجود دارد؟

به دلایل ایمنی، کل ویژگی بارگذاری پیش‌دستانه به طور پیش‌فرض برای کاربران وارد شده و سایت‌هایی که از پیوندهای یکتا زیبا استفاده نمی‌کنند، غیرفعال است. مورد دوم به این دلیل است که افزونه‌ها اغلب از URLها با پارامترهای کوئری سفارشی استفاده می‌کنند تا به کاربران اجازه انجام اقدامات را بدهند، و چنین URLهایی نباید به صورت پیش‌دستانه بارگذاری شوند. برای سایت‌های بدون پیوندهای یکتا زیبا، تمایز بین اینکه کدام پارامترهای کوئری پیش‌فرض‌های هسته هستند و کدام پارامترهای کوئری سفارشی هستند، غیرممکن یا حداقل بسیار پیچیده است.

اگر این افزونه را در سایتی بدون پیوندهای یکتا زیبا (pretty permalinks) اجرا می‌کنید و مطمئن هستید که هیچ پارامتر کوئری سفارشی در حال استفاده نیست که بتواند باعث تغییر وضعیت شود، می‌توانید بارگذاری پیش‌دستانه را از طریق فیلتر plsr_enabled_without_pretty_permalinks فعال کنید:

<?php
add_filter( 'plsr_enabled_without_pretty_permalinks', '__return_true' );

این چه تأثیری بر تجزیه و تحلیل و شخصی‌سازی خواهد داشت؟

پیش‌رندر می‌تواند بر تجزیه و تحلیل (analytics) و شخصی‌سازی تأثیر بگذارد.

برای جاوا اسکریپت سمت کلاینت، توصیه می‌شود این موارد را تا زمانی که پیش‌رندر فعال شود (مثلاً با کلیک روی لینک) به تأخیر بیندازید. برخی راهکارها (مانند Google Analytics) قبلاً این کار را به طور خودکار انجام می‌دهند، تأثیر بر تجزیه و تحلیل را ببینید. علاوه بر این، آی‌فریم‌های با منشأ متفاوت (cross-origin) تا زمان فعال‌سازی بارگذاری نمی‌شوند که می‌تواند از مشکلات در اینجا جلوگیری کند.

حدس و گمان با اشتیاق پیش‌فرض moderate (متوسط) خطر عدم بازدید صفحه پیش‌رندر شده توسط کاربر را کاهش می‌دهد و بنابراین از هرگونه عوارض جانبی بارگذاری پیش از موعد چنین لینکی جلوگیری می‌کند. در مقابل، حدس و گمان eager (مشتاقانه) خطر عدم بارگذاری صفحات پیش‌رندر شده را افزایش می‌دهد. به عنوان جایگزین، این افزونه پیشنهاد می‌کند که فقط با کلیک ماوس/اشاره‌گر (محافظه‌کارانه) حدس بزند که خطر را حتی بیشتر کاهش می‌دهد و گزینه‌ای برای سایت‌هایی است که نگران این موضوع هستند، به قیمت داشتن زمان پیش‌روی کمتر و در نتیجه افزایش عملکرد کمتر.

یک صفحه پیش‌رندر شده به صفحه‌ای که آن را پیش‌رندر می‌کند مرتبط است، بنابراین ممکن است شخصی‌سازی در این مرحله شناخته شده باشد و تغییرات (مانند مرور سایر محصولات، یا ورود/خروج) اغلب نیاز به بارگذاری صفحه جدید و در نتیجه پیش‌رندر جدید دارند که سپس این موارد را در نظر می‌گیرد. اما قطعاً چیزی است که باید از آن آگاه بود و آزمایش کرد! در صورت نیاز زمانی که وضعیت بدون بارگذاری صفحه جدید تغییر می‌کند، صفحات پیش‌رندر شده را می‌توان با حذف عنصر <script> قوانین حدس و گمان از صفحه با استفاده از APIهای استاندارد JavaScript DOM لغو کرد.

کجا می‌توانم بازخورد خود را درباره افزونه ارسال کنم؟

بازخوردها تشویق شده و بسیار قدردانی می‌شوند، به خصوص که این افزونه ممکن است شامل ویژگی‌های آینده هسته وردپرس باشد. اگر پیشنهاد یا درخواستی برای ویژگی‌های جدید دارید، می‌توانید آن‌ها را به عنوان یک issue در مخزن گیت‌هاب تیم عملکرد وردپرس ثبت کنید. اگر برای عیب‌یابی به کمک نیاز دارید یا سوالی درباره افزونه دارید، لطفاً یک موضوع جدید در انجمن پشتیبانی ما ایجاد کنید.

کجا می‌توانم باگ‌های امنیتی را گزارش دهم؟

تیم عملکرد و جامعه وردپرس باگ‌های امنیتی را جدی می‌گیرند. ما از تلاش‌های شما برای افشای مسئولانه یافته‌هایتان قدردانی می‌کنیم و تمام تلاش خود را برای به رسمیت شناختن مشارکت‌های شما انجام خواهیم داد.

برای گزارش یک مشکل امنیتی، لطفاً از برنامه WordPress HackerOne بازدید کنید.

چگونه می‌توانم در افزونه مشارکت کنم؟

مشارکت‌ها همیشه مورد استقبال هستند! درباره نحوه مشارکت در دستورالعمل تیم عملکرد هسته بیشتر بیاموزید.