شورت‌کدهای ووکامرس را بشناسیم

ووکامرس به همراه شورت​‌کدها يا کدهاي کوتاه متعددي ارائه مي​‌شود. مي​‌توان از شورت‌کدهای ووکامرس به منظور قرار دادن محتوا در برگه‌ها و نوشته‌​ها استفاده نمود. گاهی پیش می‌آید که به بنا به دلایلی برخی از برگه‌های مهم مانند تسویه حساب در فروشگاه از بین می‌روند. اصلا جای نگرانی نیست! کافیست شورت‌کد مربوطه را یافته و در یک برگه قرار دهید. صفحه تسویه حساب شما به راحتی ایجاد می‌شود. برای این منظور لازم است با کدهای کوتاه در ووکامرس آشنا شویم و آن‌ها را شناسایی کنیم.

شورت‌کدهای ووکامرس

در برگه‌​ها و نوشته​‌ها می​‌توان از شورت‌کدهای ووکامرس استفاده کرد. اگر از ويرايشگر بلوک استفاده می​‌کنيد، نخست باید بلوک کد کوتاه را انتخاب کنيد.

سپس شورت‌کدهای ووکامرسی که مد نظرتان است را جايگذاری کنيد. به عنوان مثال برگه سبد خرید…

اگر از ويرايشگر کلاسيک وردپرس استفاده می‌کنيد، فقط کافيست شورت​‌کدهای ووکامرس را در محل مد نظرتان قرار دهيد. یعنی در سمت ویرایشگر متن.

پارامترها يا آرگومان​‌ها

بعضی از شورت​‌کدهای ووکامرس با پارامترها يا آرگومان​‌ها همراه هستند. آرگومان​‌ها اين امکان را فراهم می‌​کنند که بتوان از شورت​کدها يا کدهای کوتاه ووکامرس به شکل مطلوب‌​تري استفاده کرد. به عنوان مثال  اگر “id=”99 را به کد کوتاه [add_to_cart] اضافه کنيم، يک دکمه افزودن به سبد خرید برای محصولی که آيدی آن 99 است، ايجاد می​‌شود.

[ "add_to_cart id="99]

شورت​‌کدهای ووکامرس

ووکامرس بدون استفاده از کدهای کوتاه زير، عملکرد صحيحی نخواهد داشت. کدهای کوتاه در ووکامرس بايد در مکانی در سايت شما استفاده شده باشند:

• [woocommerce_cart] – برگه کارت يا همان سبد خريد را نشان می‌​دهد.
• [woocommerce_checkout] – برگه پرداخت را نشان می‌​دهد.
• [woocommerce_my_account] – برگه حساب مشتری را نشان می‌​دهد.
• [woocommerce_order_tracking] – فرم پيگيری سفارش را نشان می‌​دهد.

در برخی از موارد، شورت‌کدهای ووکامرس توسط Wizard Onboard به صورت خودکار به برگه​‌ها اضافه می‌​شوند و نيازی نيست که شما به صورت دستی اين کار را انجام دهيد.

شورت​‌کد Cart

اين شورت‌​کد در برگه کارت يا همان سبد خريد استفاده می​‌شود و محتوای سبد خريد، رابط کاربری برای کدهای تخفيف و ساير محتوای مرتبط با سبد خريد را نشان می​‌دهد.
آرگومان​‌ها: اين شورت‌کد آرگومانی ندارد.

[woocommerce_cart]

شورت​‌کد Checkout

در برگه پرداخت استفاده می‌​شود و فرآيند پرداخت را نشان می‌​دهد.
آرگومان‌​ها: اين شورت​‌کد آرگومانی ندارد.

[woocommerce_checkout]

شورت​‌کد My Account

اين شورت​‌کد، بخش حساب من را نشان می‌​دهد. در اين بخش، مشتری می‌​تواند سفارش​‌های پيشين خود را مشاهده کرده و اطلاعات کاربری خود را بروزرسانی کند. همچنین می‌​توان تعداد سفارش​‌هايی که در اين بخش نمايش داده می​‌شود را سفارشی​‌سازی کرد. در حالت پيش​‌فرض، ۱۵ سفارش آخر نمايش داده می​‌شود (اگر می​‌خواهيد تمامی سفارشات نمايش داده شود از ۱- استفاده کنيد).
آرگومان‌​ها :

</pre>
<pre class="wp-block-preformatted">array(
     'current_user' => ''
 )</pre>
<pre>

شورت​‌کد Order Tracking

به کاربر امکان می​‌دهد که با وارد کردن جزئيات، سفارش خود و وضعيت آن را مشاهده کند.
آرگومان​‌ها: اين شورت​‌کد آرگومانی ندارد.

[woocommerce_order_tracking]

شورت​‌کد Products

توجه: در هسته ووکامرس از نسخه 3.6 به بعد، چندين بلوک محصول قرار داده شده است. پيکربندی اين بلوک​‌ها نسبت به شورت‌​کدهای ووکامرس ساده‌​تر است.

شورت​‌کد [products] يکی از بهترين شورت​‌کدهای ووکامرس است که می‌​تواند جايگزين انواع رشته​‌های مورد استفاده در نسخه‌​های قبلی ووکامرس شود.
شورت​‌کد [products] به شما اين امکان را می​‌دهد که محصولات را با استفاده از آيدی نوشته، SKU، دسته​‌ها و ويژگی​‌ها نمايش دهيد و همچنين از صفحه‌​بندی، نمايش تصادفی و برچسب​‌های محصول نيز پشتيبانی می‌​کند. بدين ترتيب ديگر نيازی به استفاده از شورت​کدهای[featured_products], [sale_products], [best_selling_products], [recent_products],  [product_attribute]  و [top_rated_products] که در نسخه ​های قبل از 3.2 استفاده می‌شدند، نيست.

ويژگی‌​های موجود برای محصول

ويژگی‌​های زير را می​‌توان به همراه شورت​‌کد [products] مورد استفاده قرار داد. به منظور درک آسان‌​تر، اين ويژگی​‌ها را با توجه به تابع اوليه به بخش‌​های زير تقسيم کرده​ و در ادامه مطلب چند مثال برای درک بهتر این موضوع آورده‌ایم.

ويژگی​‌های نمايش محصول

• limit – تعداد محصولاتی که می​‌خواهيم نمايش داده شود. پيش​‌فرض 15 است و 1- تمامی محصولات را نمايش می‌​دهد.
• columns – تعداد ستون​‌های نمايش​ داده شده، پيش‌​فرض 4 است.
• paginate – فعال‌سازی صفحه​‌بندی. به همراه limit به کار می‌​رود. پيش‌​فرض آن مقدار false دارد. به منظور فعال‌سازی بايد مقدار آن را برابر با true قرار دهيم.
• orderby – مرتب​‌سازی محصولات نمايش داده شده براساس معيار انتخابی. می‌​توان با استفاده از نامک‌​ها يک يا چند معيار انتخاب کرد، نامک​‌ها بايد با فاصله از هم جدا شوند. معيارهای زير قابل استفاده هستند:
  • تاريخ انتشار محصول
  • آيدی نوشته محصول
  • ترتيب منو، اگر تنظيم شود شماره​‌های پايين‌​تر نخست نمايش داده می​‌شوند.
  • تعداد خريدها (محبوبيت)
  •  به صورت تصادفی (ممکن است در بعضی از سايت​‌ها که از کش استفاده می‌​کنند درست کار نکند)
  • ميانگين امتيازات محصول
  • عنوان محصول (گزينه پيش‌​فرض اين وِيژگی همين مورد است)
• skus – ليست SKUهای محصولات که با کاما (،) از هم جدا شده‌​اند.
• category – ليست نامک​‌های دسته​‌ها که با کاما (،) از يکديگر جدا شده‌​اند.
• tag – ليست نامک‌​های برچسب​‌ها که با کاما (،) از يکديگر جدا شده‌​اند.
• order – مشخص می​‌کند که آيا ترتيب نمايش محصولات که در ويژگی orderby تعيين شده است صعودی (ASC) باشد يا نزولی (DESC). مقدار پيش‌​فرض ASC است.
• class – يک کلاس دربرگيرنده HTML اضافه می‌کند که می‌​توان از آن به منظور تعيين استايل خروجی با CSS استفاده کرد.
• on_sale – محصولات در حال فروش را برمی​‌گرداند. نبايد با best_selling يا top_rated استفاده شود.
• best_selling – محصولاتی که بهترين فروش را داشته‌​اند، برمی​‌گرداند. نبايد با on_sale يا top_rated استفاده شود.
• top_rated – محصولاتی که بالاترين امتياز را دارند، برمی​‌گرداند. نبايد با on_sale يا best_selling استفاده شود.

ويژگی‌​های محتوای محصول

• attribute – محصولاتی که از يک نامک ويژگی معين استفاده می‌​کنند، را برمی​‌گرداند.
• terms – ليست گزاره​‌های ويژگی‌​ها را برمی​‌گرداند که بايد به همراه attribute استفاده شود.
• terms_operator – عملگر مورد استفاده برای مقايسه گزاره​‌ها. عملگرهای زير قابل استفاده​ هستند:
  • AND – محصولات تمامی ويژگی​‌های انتخابی را نمايش خواهد داد.
  • IN – محصولات موجود در وِيژگی انتخابی را نمايش خواهد داد. مقدار پيش​‌فرض term_operator همين مقدار است.
  • NOT IN – محصولاتی را که در ويژگی يا ويژگی​‌های انتخابی وجود ندارند، نمايش خواهد داد.
• tag_operator – عملگر مورد استفاده برای مقايسه برچسب​‌ها. عملگرهای زير قابل استفاده هستند:
  • AND – محصولات موجود در تمامی برچسب‌​های انتخابی را نمايش می​‌دهد.
  • IN – محصولات موجود در برچسب​‌های انتخابی را نمايش می​دهد. مقدار پيش‌​فرض tag_operator همين مقدار است.
  • NOT IN – محصولاتی را که در برچسب‌​های انتخابی قرار ندارند، نمايش می​‌دهد.
• visibility – محصولات را بر اساس قابليت مشاهده نمايش می​‌دهد. گزينه​‌های زير در دسترس است:
  • visible – محصولاتی که در فروشگاه و نتايج جستجو قابل مشاهده هستند، را نمايش می​‌دهد. مقدار پيش‌​فرض visibility همين مقدار است.
  • catalog – محصولاتی را نشان می​‌دهد که فقط در فروشگاه قابليت مشاهده دارند، نه در نتايج جستجو.
  • search – محصولاتی را نشان می​دهد که فقط در نتايج جستجو قابليت مشاهده دارند، نه در فروشگاه.
  • hidden – محصولاتی که از ديد فروشگاه و جستجو مخفی شده‌​اند و فقط با URL مستقيم قابليت مشاهده دارند را نشان
    می​‌دهد.
  • featured – محصولاتی را نشان می‌​دهد که به عنوان ويژه يا شاخص نشان​‌گذاری شده‌​اند.
• category – محصولات را با استفاده از نامک دسته معين شده، برمی​‌گرداند.
• tag – محصولات را با استفاده از نام برچسب معين شده، برمی​‌گرداند.
• cat_operator -عملگر مورد استفاده برای مقايسه گزاره​‌های دسته. عملگرهای زير در دسترس است:
  • AND – محصولاتی را نشان می‌​دهد که متعلق به تمامی دسته‌​های انتخابی باشند.
  • IN – محصولاتی را نشان می​‌دهد که در دسته انتخابی قرار داشته باشند. مقدار پيش‌​فرض cat_operator همين مقدار است.
  • NOT IN – محصولاتی را نشان می‌دهد که در دسته انتخابی قرار ندارند.
• ids – محصولات را بر اساس ليست آيدی برگه​‌ها نمايش می​‌دهد.
• skus – محصولات را بر اساس ليست SKUها نمايش می​‌دهد.

اگر محصول نمايش داده نمی​‌شود، بررسی کنيد که در بخش قابليت مشاهده کاتالوگ، بر روی “Hidden” تنظيم نشده باشد.
برای پيدا کردن آيدی محصول به صورت زير عمل کنيد: به بخش محصولات رفته و نشانگر موس را بر روی محصول مد نظر قرار دهيد، آيدی محصول مشاهده می‌شود.

ويژگی​‌های ويژه محصول

اين ويژگی​‌ها را نمی‌​توان به همراه ويژگی‌​های محتوا به کار برد، زيرا اين احتمال وجود دارد که يک تعارض در بين آن‌ها بوجود بيايد و در نتيجه نمايش داده نشوند. شما فقط می​‌توانيد يکی از ويژگی‌های ويژه زير را استفاده کنيد:

• best_selling – محصولاتی که بهترين فروش را دارند، نمايش می​‌دهد. مقدار آن بايد برابر true تنظيم شود.
• on_sale – محصولاتی که در حال فروش هستند، را نمايش می‌​دهد. مقدار آن بايد برابر true تنظيم شود.

مثال​هايی برای استفاده از کدهای کوتاه ووکامرس در سناريوهای مختلف محصولات

در سناريوهای زير از يک فروشگاه لباس به عنوان نمونه استفاده کرده‌​ايم.

سناريوی شماره 1 – اقلام فروش تصادفی

می​‌خواهيم چهار محصول تصادفی برای فروش را نمايش دهيم. از کد زير استفاده می​‌کنيم:

["products limit="4" columns="4" orderby="popularity" class="quick-sale" on_sale="true]

اين شورت​کد چهار محصول در چهار ستون (يک رديف) تنظيم می​‌کند و محبوب​‌ترين اقلام در حال فروش را نمايش می​‌دهد. همچنين کلاس quick-sale را نيز اضافه می​‌کند که می​‌توان از آن به منظور تعيين استايل در پوسته استفاده کرد. خروجی به شکل تصوير زير خواهد بود:

سناريوی شماره 2 – محصولات ويژه

می​‌خواهيم محصولات ويژه را به نحوی که در هر رديف دو محصول قرار بگيرد و حداکثر چهار آيتم نمايش داده شود، نمايش دهيم.

["products limit="4" columns="2" visibility="featured]

توضيح شورت‌کدهای ووکامرس بالا بدين شرح است: حداکثر 4 محصول در دو ستون بارگذاری خواهد شد و اين محصولات بايد ويژه باشند. همچنين از برخی مقادير پيش​‌فرض نيز استفاده می​‌شود، هر چند که به شکل صريح تعريف نشده​‌اند؛ مثلا مرتب‌​سازی براساس عنوان محصول و طبق حروف الفبا انجام می‌شود.

سناريوی شماره 3 – محصولاتی که بهترين فروش را داشته‌​اند

می​‌خواهيم سه محصول که بهترين فروش را داشته‌​اند، با کمک شورت‌کدهای ووکامرس در يک رديف نمايش دهيم.

["products limit="3" columns="3" best_selling="true]

سناريوی شماره 4 – جديدترين محصولات

می​خواهيم جديدترين محصولات قبل از ساير محصولات نمايش داده شوند و چهار محصول در يک رديف نمايش داده شود. برای انجام اين کار از آيدی نوشته​‌ها (که در زمان ساخت برگه محصول ايجاد می​‌شود) به همراه دستورات order و orderby استفاده می‌​کنيم. از آنجايی که امکان مشاهده آيدی نوشته​‌ها در فرانت​اند يا سمت کاربر ميسر نيست، آيدی​‌ها بر روی تصاوير نوشته شده‌​اند.

["products limit="4" columns="4" orderby="id" order="DESC" visibility="visible]

سناريوی شماره 5 – دسته​‌بندی​‌های معين

می‌​خواهيم دسته​‌های کاپشن (hoodies) و پيراهن (shirts) نمايش داده شود اما دسته لوازم جانبی (accessories) نمايش داده نشود. همچنين می​‌خواهيم که محصولات در دو رديف با چهار ستون نمايش داده شود.

["products limit="8" columns="4" category="hoodies, tshirts" cat_operator="AND]

اگر بخواهيم محصولاتی که در اين دو دسته هستند، نمايش داده نشود، کافی است در cat_operator بجای AND از NOT IN استفاده کنيم.

["products limit="8" columns="4" category="hoodies, tshirts" cat_operator="NOT IN]

توجه کنيد که اگرچه حداکثر تعداد را 8 عدد انتخاب کرده‌​ايم، اما فقط 4 محصول وجود دارد که با معيار انتخابی مطابقت دارند، بنابراين فقط چهار محصول نمايش داده می‌شود.

سناريوی شماره 6 – نمايش ويژگی

هر يک از لباس‌​ها با توجه به فصل مناسب دارای يک ويژگی بهار/تابستان يا پاييز/زمستان هستند. بعضی از محصولات دارای هر دو ويژگی هستند. در اين مثال می‌​خواهيم در هر رديف سه محصول را نمايش دهيم به نحوی که همگی اقلام مربوط به بهار/تابستان باشند، از نامک ويژگی season استفاده می​‌کنيم و ويژگی‌​ها نيز warm و cold هستند. همچنين می‌خواهيم ابتدا محصولات جديدتر نمايش داده شوند.

["products columns="3" attribute="season" terms="warm" orderby="date]

اگر بخواهيم منحصرا محصولات فصل سرد را نمايش دهيم، می‌​توانيم به terms_operator عملگر NOT IN را اضافه کنيم.

["products columns="3" attribute="season" terms="warm" terms_operator="NOT IN]

توجه کنيد که استفاده از NOT IN باعث می‌​شود محصولاتی که در هر دو دسته بهار/تابستان و پاييز/زمستان هستند نيز حذف شوند. اگر می​‌خواستيم تمامی محصولاتی که برای فصل سرد مناسب هستند، و همچنين محصولاتی که برای هر دو فصل مناسب هستند را نمايش دهيم، بايد بجای warm از cold استفاده می​‌کرديم.

سناريوی شماره 7 – فقط نمايش محصولاتی که دارای برچسب “hoodie” هستند

["products tag="hoodie]

استفاده از کدهای کوتاه ووکامرس به منظور مرتب​‌سازی محصولات با زمينه‌​های متای سفارشی

در هنگام استفاده از شورت‌کدهای ووکامرس برای محصولات، شما مي​‌توانيد محصولات را با استفاده از مقادير از پيش تعريف شده مرتب کنيد. همچنين می​‌توانيد از زمينه‌​های متای سفارشی نيز استفاده کنيد. بدين منظور بايد از کد زير استفاده کنيد (در اين مثال مرتب ​سازی محصولات براساس قيمت صورت گرفته است):

add_filter( 'woocommerce_shortcode_products_query', 'woocommerce_shortcode_products_orderby' );

function woocommerce_shortcode_products_orderby( $args ) {

    $standard_array = array('menu_order','title','date','rand','id');

    if( isset( $args['orderby'] ) && !in_array( $args['orderby'], $standard_array ) ) {
        $args['meta_key'] = $args['orderby'];
        $args['orderby']  = 'meta_value_num'; 
    }

    return $args;
}

بايد قطعه کد بالا را در فايل فانکشن (functions.php) پوسته قرار داده و سپس با استفاده از meta_key آن را سفارشی کنيد.

دسته محصول

دو شورت‌​کد زير، دسته​‌های محصولات را در هر برگه‌​ای نمايش خواهند داد.

• [product_category] – محصولات موجود در يک دسته خاص را نشان می‌​دهد.
• [product_categories] – تمامی دسته‌​های محصولات را نمايش می‌​دهد.

ويژگی​‌های دسته‌​های محصولات

• ids – تعيين آيدی دسته​‌های خاص به منظور تهيه ليست
• limit – تعداد دسته‌​هايی که قصد نمايش آن‌ها را داريم.
• columns – تعداد ستون​‌ها به منظور نمايش دسته​‌ها. پيش‌​فرض مقدار 4 است.
• hide_empty – مقدار پيش‌​فرض “1” است که دسته​‌های خالی را پنهان می​‌سازد. اگر برابر “0” تنظيم شود، دسته​‌های خالی نيز نمايش داده می‌​شوند.
• parent – آيدی دسته​ والد که می​‌خواهيم تمامی دسته​‌های فرزند آن نمايش داده شوند.
• orderby – مقدار پيش‌​فرض نام است که می‌​تواند مقادير آيدی، نامک و یا ترتيب منو را نيز در برگيرد. اگر مایل هستید که با تعيين آيدي​‌های معين نمايش داده شود، می‌​توانيد از “orderby=”include استفاده کنيد.
• order – مشخص می‌​کند که روش تعيين شده در orderby به صورت صعودی (ASC) باشد يا نزولی (DESC). مقدار پيش‌​فرض صعودی است.

استفاده از شورت​کدهای ووکامرس در چند سناريوی نمونه برای دسته محصول

سناريوی شماره 8 – فقط نمايش دسته‌​های سطح بالا

فرض کنيد می​‌خواهيد فقط دسته​‌های سطح بالا (دسته‌​هايی که والد ندارند) را در يک برگه نشان دهيد و زيردسته​‌ها را حذف کنيد. با استفاده از شورت‌کدهای ووکامرس زير می‌​توانيد اين کار را انجام دهيد.

["product_categories number="0" parent="0]

برگه محصول

نمايش يک برگه محصول منفرد با استفاده از آيدی يا SKU.

[product_page id="99"]
[product_page sku=”FOO”]

محصولات مرتبط

ليست کردن محصولات مرتبط.

آرگومان‌ها:

array(
     'limit' => '12',
     'columns' => '4',
     'orderby' => 'title'
 )

[related_products limit=”12″]

پارامتر limit: توجه کنيد که پارامتر “limit” فقط تعيين می​‌کند که چه تعداد محصول در برگه نمايش داده شود و قابليت صفحه‌​بندی را به شورت‌کدهای ووکامرس اضافه نمی​‌کند.

افزودن به سبد

نمايش قيمت و دکمه افزودن به سبد برای يک محصول با استفاده از آيدی.

آرگومان​‌ها:

array(
      'id' => '99',
      'style' => 'border:4px solid #ccc; padding: 12px;',
      'sku' => 'FOO'
      'show_price' => 'TRUE'
      'class' => 'CSS-CLASS'
      'quantity' => '1';
 )

URL افزودن به کارت

نمايش URL دکمه افزودن به سبد يک محصول با استفاده از آيدی.

آرگومان​‌ها:

array(
      'id' => '99',
      'sku' => 'FOO'
 )

نمايش آگاه​سازهای ووکامرس در برگه​‌هايی که ووکامرس نيستند

شورت‌کدهای ووکامرس مانند [shop_messages] به شما اين امکان را می‌​دهد که آگاه‌​سازهای ووکامرس (مانند محصول به سبد اضافه شد) را در برگه‌​های غيرووکامرسی نمايش دهيد. اين شورت​‌کد می‌​تواند هنگام استفاده از ساير شورت​‌کدها، مانند [add_to_card، مفيد باشد. همچنين مطلوب است که کاربران بر اساس عملی که انجام می​‌دهند، بازخوردی دريافت کنند.

عيب ​يابی کدهای کوتاه در ووکامرس

اگر کد کوتاه ووکامرس را وارد کرده‌​ايد اما ظاهر نمايش مشکل دارد، نخست اطمينان حاصل کنيد که کد کوتاه را در بين تگ‌های <pre> قرار نداده باشید. اين يک مشکل مرسوم است. به منظور حذف اين تگ‌ها به ويرايش برگه رفته و روی گزینه زبانه متن همانند تصوير زير کليک کنيد.

يکی ديگر از مشکلات رايج کدهای کوتاه در وکامروس، اين است که علامت نقل قول مستقيم (“) به شکل علامت نقل قول مورب (“) نمايش داده می‌شود. برای اينکه شورت‌کدهای ووکامرس عمل کنند، بايد از علامت نقل قول مستقيم استفاده کنيد.

منبع: woocommerce