Author: Neil Lock

From the word itself, the word shortcode means exactly that: A short code; a shortcut code.

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

د مثال په توګه، د اوږدوالي له پلوه د کوډ یوه عادي برخه به ممکن داسې څه ښکاري:

<html>Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Etiam id aliquam turpis. Vivamus quis arcu tincidunt, finibus urna eget, placerat risus.

Aliquam arcu massa, finibus et lacinia sed, scelerisque nec augue. Quisque eu viverra sapien, vel consequat lorem. Integer vel erat tortor.

Phasellus condimentum magna eget congue venenatis. Suspendisse blandit vehicula consectetur.

Nullam sodales eleifend massa, in bibendum purus fermentum id.

Morbi et turpis feugiat, malesuada ipsum sit amet, interdum nulla. In non ante nec nisl mattis gravida sit amet id lectus.

</html>​

د دې مثال لپاره، راځئ داسې وګڼو چې پورته د کوډ برخه به تاسو ته اجازه درکړي چې د Lorem Ipsum ځای نیسونکي متن یو بشپړ پراګراف اضافه کړئ.

Now, a shortcode with the same exact function as the code above will look something like this, in contrast:

[lorem ipsum dolor estat]Lorem Ipsum[/lorem]​

You can see how they’re miles different from each other in terms of length.

اوس تصور وکړئ چې د کوډ دواړه برخې – اصلي، اوږده برخه، او په مقابل کې هغه لنډکوډ چې یوازې د “lorem” کلمه لري، دواړه به کټ مټ یو کار ترسره کړي: د Lorem Ipsum متن اضافه کول.

This is what shortcodes do. They make adding widgets, functions, and a bunch of other cool stuff easier for both ordinary WordPress users and developers alike.

Where can I find shortcodes?

که تاسو کوم د خوښې پلګ ان یا ویجټ لرئ، نو ډېر احتمال شتون لري چې هغوی ستاسو د کارولو لپاره یو لنډکوډ ولري.

Shortcodes Ultimate, for example, will let you choose from hundreds of shortcodes that you can use on Page Builder Sandwich (or anywhere, actually) by simply grabbing the shortcode of your choice from Shortcode Ultimate’s repository or documentation page.

Adding Custom Shortcodes on PBS

په Page Builder Sandwich کې، تاسو کولی شئ یوازې د ټایپ کولو یا کاپي پېسټ کولو له لارې لنډکوډونه مستقیم ستاسو د محتوا ساحې یا پاڼې ته اضافه کړئ.

موږ دا چاره لاندې د Shortcodes Ultimate څخه د یو لنډکوډ سره ترسره کړې ده، چې د Page Builder Sandwich ډیمو پاڼه کې مو د محتوا یو بکس اضافه کړی دی:

Another thing you’ll find handy when using Page Builder Sandwich is our Shortcode Mapping feature.

د لنډکوډ نښلولو (Shortcode Mapping) په اړه زموږ له پخوانیو مقالو څخه یوه کې، تعریف په لاندې ډول دی:

Shortcode mapping is like letting Page Builder Sandwich memorize all the shortcodes available on your site: their names, descriptions, their attributes, and what each of these attributes do.

د دې یوه برخه پدې معنی ده چې تاسو نور اړتیا نلرئ په لاسي ډول د خپلو لنډکوډونو په خپلو اړوندو اسنادو یا زېرمو کې لټون وکړئ.

تر هغه چې تاسو هغه پلګ ان چې لنډکوډ لري په خپل ورډپریس سایټ کې نصب کړی وي، دا به په Page Builder Sandwich کې ستاسو د کارولو لپاره په اسانۍ سره شتون ولري.

So for example, if I wanted to add a WooCommerce shortcode on my page, all I have to do is make sure that it’s installed on my WordPress site, like so:

And then, to actually add the shortcode, I’ll just go to my page, and drag and drop the Shortcode Element:

Because we already have WooCommerce installed on our WordPress site, you can see that all of the shortcodes that are available on the WooCommerce plugin are already available on Page Builder Sandwich. This is what Shortcode Mapping is.

You can also see on the upper left corner that the ACF (Advanced Custom Fields) and MailChimp shortcodes are available– because we have those instlled on our WordPress site, too.

نو که تاسو غواړئ دودیز لنډکوډونه اضافه کړئ، یا هغه لنډکوډونه چې تاسو پخپله جوړ کړي دي، تاسو یې اضافه کولی شئ، تر هغه چې تاسو دوی په خپل ورډپریس سایټ کې نصب کړي وي.

Here are some other helpful plugins that you can use to create your own custom shortcodes:

دلته په لسګونو د پاڼې جوړوونکي شتون لري، او تاسو باید له ځانه پوښتنه وکړئ: د Page Builder Sandwich په اړه څه شی دومره ځانګړی دی؟ که تاسو مخکې له مخکې یو په لاس کې لرئ، ولې غواړئ د دې کارولو زحمت وباسئ؟

په دې مقاله کې، زه به د Page Builder Sandwich ځینې کلیدي ځانګړتیاوې بیان کړم چې دا بې سارې کوي، او دا د مینځپانګې جوړونکو او ډیزاینرانو دواړو لپاره یوه بشپړه اړتیا ګرځوي. که تاسو نه پوهېږئ چې د پاڼې جوړوونکی څه شی دی او ولې ورته اړتیا لرئ، اندېښنه مه کوئ، موږ ځینې مواد لرو چې تاسو سره مرسته کولی شي.

1. تاسو به یوازې د خپلې مینځپانګې بصري نمایش ونه ګورئ، تاسو خپله اصلي مینځپانګه وینئ او سموئ

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

د Page Builder Sandwich سره، ټول سمون ستاسو د سایټ په مخکینۍ برخه کې ترسره کیږي او تاسو خپله مینځپانګه په مستقیم ډول د یوې رښتینې هغه-څه-چې-وینئ-هغه-ترلاسه-کوئ تجربې لپاره سموئ.

2. له هغو ټولو ځورونکو پاپ اپ کړکیو پرته چټک او اسانه مستقیم سمون

پاپ اپونه د پاڼو جوړوونکو یوه اصلي برخه پاتې شوې ده. په ډېری کې، که تاسو غواړئ په خپل ترتیب کې هر څه سم کړئ، که هغه سرلیک وي، د تڼۍ لیبل وي، یا د نښان کوچنی متن، تاسو باید لومړی د پاپ اپ کړکۍ خلاصیدو ته انتظار وکړئ او خپل بدلونونه د هغې دننه ترسره کړئ.

موږ په Page Builder Sandwich کې په ټوله کې د پاپ اپونو کارول تر لږ تر لږه کچې رسول خپل هدف ګرځولی دی. د پاپ اپونو په لیرې کولو سره، د هرې مینځپانګې سمول تر بل هر وخت اسانه او اسانه شوي دي.

سمون په ساده ډول ترسره کیږي – په خپل متن کلیک وکړئ ترڅو کرسر هلته کېږدئ او لیکل پیل کړئ. تاسو نور اړتیا نلرئ د سمون پیل کولو لپاره د TinyMCE ایډیټر لرونکې پاپ اپ کړکۍ ته انتظار وکړئ. د دې تر ټولو غوره برخه دا ده چې تاسو لاهم کولی شئ خپله مینځپانګه راښکته او ځای پر ځای کړئ.

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

3. د ورډپریس بیا کارول شوې وړتیاوې

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

ورډپریس یو لوی او په زړه پورې پلیټفارم دی او ډېری غوره وسیلې لري چې د بې شمیره ښو ونډه والو لخوا جوړې شوې دي. Page Builder Sandwich تر ممکنه حده پورې هغه وړتیاوې کاروي چې مخکې له مخکې له ورډپریس سره یوځای شوې دي.

د خپل د رنګ ټاکونکي کارولو پرځای، موږ د Iris رنګ ټاکونکی کاروو. زموږ د خپل انځور اپلوډر پرځای، موږ د میډیا مدیر کاروو. بیا د backbonejs، underscorejs، wp.hooks او wp.shortcode په څېر نور ګټور سکریپټونه هم شتون لري. موږ دا ټول کاروو، او دې زموږ ژوند اسانه کړی او د یو ډېر باثباته کوډبیس لامل هم شوی دی.

د ورډپریس د وړتیاوو بیا کارول د ځینو حیرانوونکو ښو پایلو لامل هم شوي. د مثال په توګه، له هغه وخته چې موږ د انځورونو دننه کولو لپاره د میډیا مدیر وکاراوه، دا یو خوندور حیرانتیا وه چې موږ اوس کولی شو سمدلاسه د ورډپریس ګالرۍ، ویډیو او آډیو پلی لیسټونه او ریموټ URLونه هم سمبال کړو. موږ دا هم کولی شو چې یوازې د میډیا مدیر وکاروو ترڅو د انځور سمون ترسره کړو، کوم چې د ساعتونو غیر ضروري پراختیايي ستونزو مخه ونیوله.

4. د کیبورډ نیویګیشن او شارټ کټونه

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

د مثال په توګه، په ځینو جوړوونکو کې، تاسو نشئ کولی په اسانۍ سره د هغه ځای څخه یو پراګراف/برخه پورته متن سم کړئ چیرې چې تاسو سمون کوئ ځکه چې تاسو باید د پاپ اپ کړکۍ څخه بهر کلیک وکړئ او په نوې کې دننه کلیک وکړئ. په Page Builder Sandwich کې، تاسو کولی شئ د خپل کیبورډ سره تګ راتګ وکړئ. د خپلې مینځپانګې ترمنځ د تګ راتګ لپاره د غشي تڼۍ ووهئ، دا حتی کار کوي که ستاسو بله مینځپانګه په بل قطار یا ستن کې پټه وي.

بله مهمه ځانګړتیا د undo او redo کیبورډ شارټ کټونه دي. دا ممکن په لومړي سر کې دومره مهم ونه ښکاري، مګر د دې په اړه فکر وکړئ: څه به وشي که تاسو خپله مینځپانګه په ناڅاپي ډول په غلط ځای کې کش او کېږدئ. په ځینو پاڼه جوړوونکو کې، تاسو به اړ یاست چې دا بیرته خپل اصلي ځای ته کش کړئ. په Page Builder Sandwich کې، undo او redo دواړه کار کوي. نو که تاسو غواړئ هغه څه نوي کړئ چې لیکلي مو دي، یا غواړئ خپله کش شوې مینځپانګه (یا ډیری کش شوې مینځپانګې) بیرته راولي، یوازې undo یا redo ووهئ. Undo او redo د کش او غورځول شوې مینځپانګې او حتی د ملکیت بدلونونو لکه د فونټ اندازې او د قطار داخلي فاصلو لپاره کار کوي. دا دوی ستاسو په ایډیټ کولو ارسنال کې پیاوړې وسیلې ګرځوي.

5. د مخکینۍ برخې یو رښتینی پاڼه جوړوونکی – یو ډېر آرام او له ستونزو پاک د ایډیټ کولو تجربه

د پراختیا پرمهال زموږ ذهنیت دا دی چې په مخکینۍ برخه کې سمون باید داسې احساس نشي لکه تاسو چې لاهم د شاته برخې وسیلو په کارولو سره سمون کوئ. دا باید داسې احساس نشي لکه جوړوونکی چې په پیل کې د بیک انډ لپاره رامینځته شوی و او بیا فرنټ انډ ته لیږدول شوی وي.

په ټوله کې، زما لپاره، د Page Builder Sandwich اصلي توپیر دا دی چې موږ دا د یو “رښتیني” فرنټ انډ پاڼې جوړوونکي په توګه د جوړولو په هدف جوړ کړی دی – د دې بیا تصور کول چې د فرنټ انډ سمون باید څنګه وي.

دا مقاله به پدې اړه یو لنډ معلومات وړاندې کړي چې Page Builder Sandwich څنګه کار کوي، او موخه یې د هغو کسانو لپاره یو لومړنی لارښود دی چې پدې کې لیوالتیا لري چې زموږ د پاڼې جوړوونکی په WordPress کې له بېلابېلو شیانو سره څنګه یوځای کیږي. زه به د Page Builder Sandwich پر انفرادي ځانګړتیاوو بحث ونه غځوم، که تاسو هغه غواړئ، زموږ د ویډیوګانو پاڼې ته لاړ شئ چیرې چې موږ هر فیچر په انفرادي ډول د لنډو سکرین کاسټونو سره ښیو.

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

دا چیرته دی؟ او زه ورسره څه ایډیټ کولی شم؟

د نورو ډېرو پاڼې جوړوونکو برعکس، Page Builder Sandwich ستاسو د ویب پاڼې په فرنټ اینډ کې شتون لري. که تاسو په بیک اینډ کې یاست، موږ د محتوا ایډیټر تڼیو تر څنګ یوه “Frontend” تڼۍ چمتو کړې چې تاسو به ستاسو د پاڼې مخکینۍ برخې ته بوځي.

د Page Builder Sandwich تاسو ته اجازه درکوي چې خپل پوسټونه، پاڼې او د دودیز پوسټ ډول محتوا ایډیټ کړئ. که څه هم دا تاسو ته اجازه نه درکوي چې په مستقیم ډول خپل د لومړي مخ راټول شوي بلاګ پوسټونه، او په خپل سایټ کې نورې غیر واحدې برخې ایډیټ کړئ. یوازې پدې ډول فکر وکړئ، که هغه څه چې تاسو یې ایډیټ کول غواړئ په بیک اینډ کې د محتوا ایډیټر ولري (لکه “New Post” او “New Page”)، نو Page Builder Sandwich کارول کیدی شي. تاسو کولی شئ خپلې انفرادي پاڼې او د بلاګ لیکنې ایډیټ کړئ، او د مثال په توګه که تاسو یو پلګ ان لرئ چې د رستورانت مینو یا د پورټ فولیو توکي معرفي کوي، تاسو کولی شئ هغه هم ایډیټ کړئ.

پداسې حال کې چې په فرنټ اینډ کې یاست، موږ ستاسو په اډمین بار کې یوه آبي “Edit with Page Builder Sandwich” تڼۍ ایښې ده. یوازې په هغه کلیک وکړئ ترڅو د خپلې پاڼې ایډیټ کول پیل کړئ.

د محتوا مستقیم سمون

د Page Builder Sandwich سره، موږ د محتوا ایډیټ کول څومره چې ممکن وي اسانه او بې ستونزې کړي دي. د محتوا ایډیټ کول، ساده او اسانه دي، یوازې کلیک وکړئ او ټایپ کړئ. دا دومره ساده دی.

د انسپکټر معرفي کول

موږ ولیدل چې د پاڼو ډېری جوړوونکي ډېر پاپ اپونه لري. په شخصي توګه، زه پاپ اپ نه خوښوم ځکه چې دوی پام اړوي او اساساً تاسو ته وايي “ای، هغه څه چې کوې ودروه تر هغه چې لومړی دا ساحې ډکې نه کړې”. دوی د یوې بل ډول اسانه ایډیټ کولو تجربې بهیر خرابوي. له همدې امله، موږ په ټوله کې د پاپ اپونو کارول تر لږ تر لږه حده رسولي دي، او پرځای یې موږ انسپکټر جوړ کړی دی.

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

له انسپکټر څخه، تاسو کولی شئ د متن بېلابېل خصوصیات لکه سرلیکونه، د فونټ اندازې، بولډ، ایټالیک، د متن رنګونه، او ډېر نور تنظیم کړئ. له هغو پرته، دا تاسو ته اجازه درکوي چې عکسونه اضافه کړئ او قطارونه یا د کالمونو لرونکې محتوا جوړه کړئ. دا د لا پرمختللي سمون وړتیا هم لري لکه د بشپړې پاڼې د پلنوالي قطارونو ته د قطارونو تنظیمول، د قطار او کالم د شالید رنګونه، د محتوا عمودي سمون، او همدارنګه حاشیې او پس منظرونه. دا خورا پیاوړی دی او تاسو به وګورئ چې د ډېری کارونو لپاره به یې وکاروئ.

د WordPress له تھیمونو سره یوځای کیدل

Page Builder Sandwich په خپل ذات کې نږدې هیڅ سټایلونه نلري. کله چې تاسو خپله محتوا ایډیټ کوئ، هغه سټایلونه چې تاسو یې ګورئ تر ډېره ستاسو د تھیم پر بنسټ دي.

له شارټ کوډونو سره یوځای کیدل

شارټ کوډونه په WordPress کې یو مهم اړخ دی او ډېر احتمال لري چې تاسو به په خپل سایټ کې یو شمېر شارټ کوډونه وکاروئ. Page Builder Sandwich دا خورا ښه سمبالوي چیرې چې ستاسو شارټ کوډونه به په فرنټ اینډ کې ښودل شوي رینډر شي. شارټ کوډونه د سمون وړ هم پاتې کیږي، او ترټولو غوره برخه دا ده چې وروسته له هغه چې تاسو خپل شارټ کوډونه ایډیټ کړئ، دوی به ستاسو له بدلونونو سره یوځای بیا رینډر شي.

د اسانتیا لپاره، تاسو به وکولی شئ د انسپکټر په کارولو سره خپل شارټ کوډونه ایډیټ کړئ. که تاسو ډېر کنټرول غواړئ، تاسو به وکولی شئ په شارټ کوډونو دوه ځله کلیک وکړئ ترڅو دوی په خام شکل کې ایډیټ کړئ. له دې پرته، ستاسو په ویب پاڼه کې ټول شته شارټ کوډونه په انسپکټر کې لیست شوي دي ترڅو په اسانۍ سره ستاسو په محتوا کې شامل شي.

د ویب پاڼې د اضافي بار او دروندوالي په اړه څه؟

څوک سستې ویب پاڼې خوښوي؟ موږ نه، او خامخا تاسو هم نه. موږ ډاډ ترلاسه کړی چې Page Builder Sandwich ستاسو د ویب پاڼې پر سرعت او کارکردګۍ نږدې صفر اغیز لري. کله چې لاګ آوټ یاست، لږ تر لږه یوازې د قطار او کالم CSS سټایلونه صف کې شاملېږي، د هغو اړینو JS او CSS سکرېپټونو سره چې تاسو کارولي شارټ کوډونو لپاره اړین دي.

د پراختیا ورکوونکو لپاره

که تاسو یو پراختیا ورکوونکی ياست او ستاسو په WordPress پلګ انونو کې شارټ کوډونه لرئ، Page Builder Sandwich یو Shortcode API وړاندې کوي ترڅو تاسو په اسانۍ سره خپلو پیرودونکو ته ستاسو د شارټ کوډونو د اسانه جوړولو او بدلون لپاره ساحې چمتو کړئ.

که تاسو غواړئ وړتیاوې نورې هم پراخې کړئ یا د Page Builder Sandwich له ځینو برخو سره یوځای شئ، موږ یو لړ ګټور action او filter هوکونه هم لرو چې تاسو یې کارولی شئ.