د شارټ کوډونو ناویل شوې ستونزه

شارتکوډونه د ورډپریس له سترو ځانګړنو څخه دي. شارتکوډونه د پراختیا ورکوونکو او د سایټ جوړونکو ترمنځ یو پل دی، چې خلکو ته اجازه ورکوي د منځپانګې پېچلې برخې نږدې هر ځای چې وغواړي ځای پر ځای کړي. د پلګین جوړونکي شارتکوډونه ډېر خوښوي ځکه چې دا د هغوی کاروونکو ته لا زیاته انعطاف‌پذیري ورکوي چې څنګه او چیرته خپله منځپانګه وښيي.

که تاسو نه پوهېږئ چې شارتکوډونه څه دي او څه ډول ښکاري، دا کوډ ته ورته زاړه متنونه دي چې په مربع قوسونو کې راغلي وي. هغوی تقریباً داسې ښکاري:

دا مشخص شارتکوډ د embed شارتکوډ بلل کېږي او په اصلي بڼه په ورډپریس کې مدغم شوی دی. دا ځانګړی شارتکوډ د URL ویډیو ستاسو په منځپانګه کې ځای پر ځای کوي. که غواړئ دا وازمویئ، نو یوازې پورته شارتکوډ کاپي او په خپل سایټ کې یې وټومبئ (پیسټ کړئ).

د پردې تر شا، څه چې پېښېږي دا دي چې کله ورډپریس ستاسو په منځپانګه کې له یو شارتکوډ سره مخامخ شي، نو دا پروسس کېږي او په بل څه بدلیږي. زموږ په پورته حالت کې، هرکله چې یو

شارتکوډ وپېژندل شي، ورډپریس په شارتکوډ کې شته URL اخلي او دا د منځپانګې له هغو څو چمتو کونکو سره ګوري چې لري یې. کله چې یو پیدا کړي، نو بیا د هغې پر ځای د iframe اړوند کوډ اخلي او ښیي یې.

نو دلته ستونزه څه ده؟ دا خورا اسانه ښکاري، تاسو یوازې د قوسونو سره یو لنډ متن داخل کوئ او کار بشپړ دی.

د شارتکوډ API ته راشئ..

د شارتکوډونو ډېرښت

د شارتکوډ API پراختیا ورکوونکو ته د نویو شارتکوډونو جوړولو لاره پرانیزي. د دې له امله، پراختیا ورکوونکي کولی شي په خپلو پلګینونو کې خپل ځانګړي شارتکوډونه اضافه کړي.

دا خورا غوره ده، اوس یوازې د یوې لنډې کوډ ډوله ټوټې سره (له همدې امله ورته “شارتکوډ” نوم ورکړل شوی)، نوي او پرمختللي کاروونکي دواړه کولی شي په عملي توګه د منځپانګې هر ډول چې وغواړي هر چیرته کېږدي.

ورډپریس په خپل اصلي حالت کې یوازې یو څو شارتکوډونه لري. دا اسانه ده چې دا له حافظې ولیکئ ځکه چې یوازې څو دانې دي. خو که تاسو څو پلګینونه انسټال کړئ، د شارتکوډونو شمېر په چټکۍ سره لسګونو یا زیاتو ته رسېږي، او په ځینو مواردو کې ان له سلو هم اوړي. هر شارتکوډ د خپلو ځانګړنو (attributes) او د کارولو د څرنګوالي لارښوونې لري. هر پلګین ډېر احتمال لري چې یو ډول مستندات ولري چې څنګه د هغوی ټول شارتکوډونه کار کوي او په هر یوه کې شته ټول پیرامیټرونه لیست کړي. مګر که تاسو هڅه وکړئ چې ټول شارتکوډونه او د هغوی ځانګړنې حفظ کړئ، نو لېوني به شئ.

ستونزه دا ده چې هیڅ داسې مرکزي ځای نشته چې تاسو پکې په خپل سایټ کې شته ټول شارتکوډونه او د کارولو طریقه ومومئ.

ځینې هڅه کوي ستونزه حل کړي

ځینې پلګینونه هڅه کوي دا ستونزه د خپلو ټولو شارتکوډونو په یوه اسانه لاسرسي لرونکي ډراپ ډاون کې وړاندې کولو سره حل کړي. بیا په یوه باندې کلیک کول شارتکوډ ښکاره کوي، چې د هغې لپاره د ټولو ممکنه ځانګړنو سره بشپړ وي. نوره نو دې ته اړتیا نشته چې دا حفظ کړئ، چې دا یو ښه کار دی.

ځینې نور هم مخکې ځي او د ترتیباتو پاپ اپ فورمه زیاتوي چې د چیک بکسونه او رنګ ټاکونکي لري ترڅو د شارتکوډ ځانګړنې ډکې کړي.

دا حل تر یوې اندازې کار کوي. خو، هر پلګین یوازې خپل شارتکوډونه شمېري. نو که هر پلګین د شارتکوډ ټاکونکي خپله بڼه جوړه کړي، نو تاسو به حتماً له داسې حالتونو سره مخ شئ چې ستاسو په سکرین کې څو د شارتکوډ ټاکونکي موجود وي (دا زما سره مخکې پېښ شوي دي).

په بل عبارت، هر پلګین خپل کار کوي او د خپلو شارتکوډونو لپاره خپل حل پلي کوي. ځینې پلګینونه یا د “Add Media” تڼۍ تر څنګ نوې تڼۍ اضافه کوي، یا د TinyMCE دننه یوه نوې تڼۍ زیاتوي.

نو اوس شاید تاسو فکر کوئ، “ولې یوازې د نورو پلګینونو شارتکوډونه هم راټول نه کړو او هغه په خپل ډراپ ډاون / شارتکوډ ټاکونکي کې هم شامل نه کړو؟” هو، دا کټ مټ هغه څه دي چې ما هم فکر کاوه. مګر، دا کار تر عمل په خبرو کې اسانه دی. زه به لږ وروسته تشریح کړم چې ولې، مګر لومړی راځئ وګورو چې یو ایډیال حل به څه ډول ښکاري.

ایډیال حل

غوره پلان به دا وي چې یو داسې پلګین جوړ شي چې ستاسو په سایټ کې ټول شته شارتکوډونه راټول کړي، بیا تاسو ته لیست وړاندې کړي او همدارنګه د ټولو ځانګړنو په ډکولو کې ستاسو سره مرسته وکړي. او هرکله چې تاسو نوی پلګین انسټال کړئ، دا ټول نوي معرفي شوي شارتکوډونه به تاسو ته هم وړاندې شي.

یو مرکزي ځای تصور کړئ چیرې چې ستاسو ټول شارتکوډونه د اسانه لاسرسي لپاره ایښودل شوي وي. هر شارتکوډ به تشریح کوي چې دوی څه کوي او په کوم پلګین پورې اړه لري. بیا د هرې شته ځانګړنې لپاره، تصور وکړئ چې هر یو به یو لیبل، د هغوی لپاره د ارزښت غوره کولو یوه سمه لاره او یو تفصیل ولري. تاسو ته به ډراپ ډاونونه، د رنګ ټاکونکي، راډیو بټنونه، ټوګلونه او نور هر څه وښودل شي.

داسې څه به د وېبپاڼې او منځپانګې جوړونکو په توګه زموږ ژوند اسانه کړي. نوره به اړتیا نه وي چې بېلابېل مستندات وګورئ، یا د خپل اډمین مختلفې برخې یوازې د هغه سلایډر لپاره چې تاسو یې کارول غواړئ د تولید شوي شارتکوډ کاپي کولو لپاره وپلټئ.

خبرداری

له بده مرغه، همدا اوس د داسې څه کول خورا ستونزمن دي. د شارتکوډ د ټولو توضیحاتو پوهیدو لپاره کومه باوري لاره نشته. تاسو کولی شئ د ټولو شارتکوډونو یو لیست ترلاسه کړئ، مګر یوازې د هغوی اصلي ټاګونه/نومونه، تاسو نشئ کولی د هغوی په اړه اضافي توضیحات لکه د ځانګړنو لیست، د هغوی کار او ډولونه لکه یو متن (string)، یو رنګ یا یوه شمېره ترلاسه کړئ. او نه هم تاسو د هرې ځانګړنې لپاره یو مناسب تفصیل ترلاسه کولی شئ.

پراختیا ورکوونکو ته یو یادښت: هو، د shortcode_atts فنکشن لپاره یو نوی اضافه شوی دریم آرګیومنټ شتون لري، مګر دا یو اړین آرګیومنټ نه دی. نو تر هغه چې په نړۍ کې د هر پلګین پراختیا ورکوونکی دا عملي نه کړي، موږ به بیا هم د شارتکوډ د ټولو ځانګړنو د معلومولو لپاره کومه باوري لاره ونه لرو.

د Shortcode API د شارتکوډ د توضیحاتو اضافه کولو، د ځانګړنو ډول ټاکلو یا د ځانګړنو تشریحاتو لپاره هیڅ اسانتیا نه برابروي. او تر هغه چې خپله ورډپریس د شارتکوډونو د لاسرسي لپاره مرکزي برخه اضافه نه کړي، زه شک لرم چې دا اسانتیا به رامنځته شي.

پایله

همدا اوس د شارتکوډونو تنظیمولو دنده هر پراختیا ورکوونکي ته پرېښودل شوې ده. تر هغه چې په ورډپریس کې کومه مرکزي طریقه رامنځته نشي، نو تمه ولرئ چې په خپل بېک اینډ (شالید) کې به د “Add Shortcode” د ګڼو تڼیو لیدلو ته دوام ورکوئ. ایا دا ډول شی باید د ورډپریس اصلي برخه (WordPress Core) کې اضافه شي که نه، دا پخپله یو بل لوی بحث دی.

یو بدیل

د پاڼې جوړوونکي داسې پلګینونه شته چې دا ستونزه په بل ډول حل کوي. د شارتکوډونو د پروګراماتي پېژندلو پر ځای، هغوی د شارتکوډ نقشه کوونکي (shortcode mappers) لري چیرې چې کاروونکي کولی شي په لاسي ډول د شارتکوډ هر تفصیل دننه کړي. کله چې بشپړ شي، نو بیا د پاڼې جوړوونکي دننه د لاسرسي وړ ګرځي. که څه هم  دا کار کوي، خو دا یوازې ستاسو په خپل سایټ کې د لاسرسي وړ دي.

موږ دلته په Page Builder Sandwich کې یو داسې شی جوړوو چې هیله ده دغه د شارتکوډ پېچلې ستونزه حل کړي. زموږ د پرمختګ په اړه خبرتیا ترلاسه کولو لپاره لاندې زموږ په خبرپاڼه کې ګډون وکړئ.