Ghidul complet al codurilor scurte WordPress

Înainte de editorul de blocuri WordPress, codurile scurte WordPress erau unul dintre cele mai bune lucruri pentru a atinge editorul WordPress pentru a facilita adăugarea funcțiilor de plugin și temă la pagini, postări și alte secțiuni ale unui site web WordPress.

Odată cu trecerea la editorul de blocuri, ce înseamnă acest lucru pentru majoritatea pluginurilor și site-urilor web mai vechi care sunt încă pline de coduri scurte? Vor mai funcționa codurile scurte WordPress? Există o modalitate de a trece cu ușurință de la utilizarea codurilor scurte WordPress la blocurile WordPress?

Să aflăm. În acest ghid, vom explora codurile scurte WordPress în era editorului de blocuri WordPress.

Ce sunt codurile scurte WordPress?

Un shortcode WordPress este un bit din cod reutilizabil și dinamic înfășurat în [paranteze] . Codurile scurte vă permit să inserați cu ușurință funcții specifice ale WordPress în sine sau ale unui plugin sau temă în orice postare, pagină, tip de postare personalizată sau widget. Gândiți-vă la codurile scurte WordPress, cum ar fi „comenzile rapide” sau la macro-urile de pe site-ul dvs. web.

Puteți utiliza coduri scurte WordPress pentru a afișa conținut static care este prea obositor pentru a continua codificarea și repetarea. Și puteți utiliza, de asemenea, coduri scurte pentru a afișa conținut dinamic, cum ar fi galerii de imagini, playere audio pentru podcast-uri, calendare de evenimente sau schimbarea statisticilor pentru anumite date.

Format Shortcode

Când vine vorba de inserarea codurilor scurte, formatul de bază [paranteze] poate fi „extins” în mai multe moduri, permițându-vă să personalizați sau să adăugați informații suplimentare despre setări numite atribute . În plus, comenzile rapide pot înfășura text (sau HTML) sau chiar pot fi imbricate într-un alt cod scurt.

De exemplu, un shortcode poate avea următoarele formate:

[shortcode]

[shortcode]Some text[/shortcode]

[shortcode]<a href="http://mysite.com/">HTML content</a>[/shortcode]

[shortcode]Some text [another-shotcode] more text [/shortcode]

[shortcode icon="icon: star" background="#eeeeee" color="#F73F43" text_color="#F73F43" size="32" shape_size="16" radius="256" text_size="16" url="#" target="self" margin="0"] This is a custom icon [/shortcode]

Atribute Shortcode

Codurile scurte sunt, de asemenea, flexibile, deoarece pot fi extinse cu atribute . Cu atribute, numere scurte oferă personalizare suplimentare , pur și simplu prin adăugarea de fragmente de cod suplimentar în scurtătură.

Pluginurile și temele oferă ghiduri și rubrici suplimentare pentru a ajuta utilizatorii să utilizeze fragmentele corecte de cod scurt pentru a adăuga sau a elimina anumite elemente din ieșire.

Iată câteva exemple de coduri scurte cu atribute.

[[gallery id="123" size="medium"]]

[recent-posts posts="5"]

[recent-posts posts="5"]Posts Heading[/recent-posts]

Coduri scurte WordPress încorporate

WordPress vine cu mai multe coduri scurte încorporate pentru redarea anumitor tipuri de conținut.

[[audio]]

Shortcode-ul audio vă permite să încorporați fișiere audio și să le redați.

[[caption]]

Utilizat în principal cu imagini individuale, codul scurt al subtitrării vă permite să înfășurați subtitrări în jurul conținutului.

[[gallery]]

Codul scurt al galeriei vă permite să adăugați una sau mai multe galerii de imagini la postările și paginile dvs.

[[embed]]

Codul scurt încorporat vă permite să înfășurați elemente încorporate cu lățimea și înălțimea maximă (dar nu fixă).

[[playlist]]

Shortcode-ul listei de redare implementează funcționalitatea afișării unei colecții de fișiere audio sau video WordPress într-o postare.

[[video]]

Shortcode-ul video vă permite să încorporați fișiere video și să le redați.

Coduri scurte pentru pluginuri și teme

Temele și pluginurile specifice WordPress au coduri scurte chiar din cutie, pe care le puteți insera în editorul de postări sau pagini și vor reda rezultatul în partea frontală. Până în prezent, o mulțime de teme și pluginuri folosesc în continuare coduri scurte.

De exemplu, codurile scurte sunt adesea folosite în plugin-uri obișnuite pentru calendare, formulare, tabele, abonamente, cronometre inversă sau ghilimele extrase. Chiar și există pluginuri shortcode care vă permit să creați shortcodes pentru orice.

Temele WordPress pot utiliza, de asemenea, coduri scurte pentru a reda un anumit conținut dinamic care este pre-stilat sau furnizat de acestea.

Coduri scurte personalizate

Majoritatea dezvoltatorilor experți aleg să își creeze propriile coduri scurte, reducând în esență timpul necesar pentru a codifica ceva repetitiv. Tot ce trebuie este un fișier suplimentar simplu în directorul de fișiere pentru a crea fișierul custom-shortcodes.php . Dacă doriți să aflați corzile codurilor scurte personalizate, iată un ghid despre crearea codurilor scurte personalizate.

API-ul WordPress Shortcode

Pentru dezvoltatorii care își creează propriile coduri scurte personalizate, API-ul WordPress Shortcode oferă un set simplu de funcții pentru crearea codurilor scurte WordPress pentru utilizare în postări și pagini.

API-ul Shortcode ajută dezvoltatorii de pluginuri să creeze conținut dinamic pe care utilizatorii îl pot adăuga la pagini sau postări prin adăugarea codului scurt corespunzător în zona de conținut. Din fericire, API gestionează toate analizele complicate, eliminând necesitatea de a scrie o expresie regulată personalizată pentru fiecare shortcode. În plus, funcțiile de asistență sunt incluse pentru setarea și preluarea atributelor implicite de cod scurt.

Dezvoltatorii pot găsi documentația API-ului WordPress Shortcode pentru a afla mai multe despre:

• Manipularea atributelor
• Ieșire
• Coduri scurte de închidere vs închidere automată
• Referința funcției
• Limitări
• Sintaxa formală

Shortcodes în Editorul clasic

În trecut, codurile scurte erau inserate în editorul clasic al oricărei postări sau pagini, astfel:

Ce sunt blocurile WordPress?

Codurile scurte au fost mai întâi ... dar apoi a venit editarea bazată pe blocuri. Odată cu introducerea WordPress 5.0 a venit implementarea editorului Gutenberg planificat de mult sau a Editorului de blocuri WordPress ca editor principal de pagini și postări pentru WordPress, înlocuind editorul clasic WordPress bazat pe text care există de ani de zile.

Iată o privire asupra editorului de conținut înainte de WordPress 5.5 (ah, acestea au fost zilele!)

Editorul Gutenberg a fost anunțat pentru prima dată în versiunile anterioare ale WordPress, dar a rămas opțional până la WordPress 5.0, când a devenit editorul implicit.

Nu este nimic inerent în neregulă cu noul editor blocat. De fapt, majorității utilizatorilor le place aspectul îmbunătățit și mai curat, mai puțin intimidant din partea din spate a WordPress.

Dar odată cu editorul de blocuri WordPress au apărut blocuri WordPress. S-au dus opțiunile de formatare din partea de sus, care amintesc de aplicațiile de procesare a textului, cum ar fi Microsoft Word. În schimb, opțiunile de formatare au fost înlocuite cu opțiunile din bara laterală dreaptă cu file pentru fiecare bloc.

Blocurile WordPress sunt în esență containere de conținut. Există multe blocuri diferite pentru diferite tipuri de conținut - imagini, videoclipuri, texte, titluri, galerii - pe care le numiți.

Există chiar și un bloc WordPress pentru formatare, distanțier și divizor și sunt aranjate întâmplător în categorii pentru acces ușor.

Toate opțiunile și controalele care erau în partea de sus se află acum în partea dreaptă a editorului de pagini / postări, cu file în partea de sus care indică dacă doriți să vedeți opțiunile pentru blocul curent singur sau întregul document.

Editorul de blocuri este mai ușor și mai rapid și mai ușor de utilizat. În plus, dezvoltatorii de teme și pluginuri își fac propriile blocuri care adaugă mai multe opțiuni de blocare blocurilor implicite WordPress.

Blocuri reutilizabile vs. coduri scurte

Vechea modalitate de a salva un set de ieșiri predefinite în editorul clasic WordPress a fost prin crearea propriilor coduri scurte. Acum, această metodă a fost înlocuită cu blocuri reutilizabile .

Capacitatea de a salva blocuri predefinite și pre-personalizate a făcut, de asemenea, mai ușor să salvați aspectul și designul unui anumit bloc și să îl utilizați pe altul. La fel ca un șablon de pagină.

De exemplu, dacă adăugați un bloc de butoane și îl stilizați cu o anumită culoare, efecte de cursor etc., nu ați dori să continuați să faceți asta pe fiecare pagină la care adăugați butonul respectiv. Dacă îl schimbați într-un bloc reutilizabil, butonul este salvat pe site-ul dvs. WordPress și devine propriul bloc pe care îl puteți utiliza pe alte pagini sau postări.

De asemenea, puteți actualiza în continuare aceste blocuri convertindu-le în blocuri obișnuite, salvându-le ca unul nou (cu un nume nou) sau actualizați designul existent al blocului.

Blocuri de grup

În WordPress 5.3 a venit și introducerea blocurilor de grup și a șabloanelor.

În esență, vi se oferă posibilitatea de a grupa anumite blocuri și de a le muta sau actualiza pe toate împreună. Acest lucru a dat naștere în cele din urmă la modele de blocare. Modelele de blocare au facilitat editarea conținutului, deoarece utilizatorii ar prefera să aleagă un model și să actualizeze conținutul, mai degrabă decât să pornească de la o pânză goală.

Opțiuni de stilare bloc

Cu fiecare temă vine opțiuni de stil diferite. Și, în mod normal, stilul conținutului pe care îl adăugați pe fiecare site este predeterminat de tema dvs.

Cu editorul de blocuri, aveți opțiunea de a actualiza stilul fiecărui bloc individual, fie pentru a ieși în evidență, fie pentru a le face mai vizibile.

Blocuri și editare completă a site-ului

Cu toate aceste progrese și schimbări în modul în care creăm și construim pagini pe WordPress vine ideea și eventuala tranziție la ceea ce se numește Editarea completă a site-ului .

În lipire, majoritatea utilizatorilor au putut actualiza doar corpul real al unei postări sau pagini. Anumite aspecte ale site-ului web, precum antetul, subsolul, bare laterale și widget-uri, depind în continuare în mare măsură de temă. Acest lucru a făcut, desigur, căutarea temei perfecte, cu cantitatea potrivită de opțiuni, lupta finală pentru dezvoltatorii și utilizatorii de WordPress.

Odată cu editarea completă a site-urilor și cu introducerea Block Builder, tendința se accentuează spre a face toate secțiunile unei pagini sau postări editabile, într-un fel, folosind blocuri.

De exemplu, cea mai recentă temă WordPress Twenty-Twenty WordPress urmează acest model, oferindu-le creatorilor și proprietarilor de site-uri web un control mai mare asupra site-ului lor și cum ar dori să arate.

În viitor, dezvoltatorii de pluginuri și teme vor trebui să adopte o abordare diferită atunci când își dezvoltă software-ul pentru a se adapta la noua experiență completă de editare a site-ului și de creare a paginilor editorului de blocuri WordPress. Deși aplicarea completă a acestui lucru este încă la orizont, este o schimbare pozitivă pe care probabil că am vedea-o mai devreme decât mai târziu.

Noul bloc Shortcode

Înainte de editorul de blocuri, codurile scurte erau inserate direct în pagina sau editorul de pagini. Acum, editorul de blocuri WordPress include un nou bloc de coduri scurte .

Blocul shortcode facilitează utilizarea în continuare a shortcodes-urilor vechi într-o postare sau pagină și menține integritatea rezultatului shortcode.

Blocul shortcode poate fi adăugat la o pagină sau la o postare făcând clic pe butonul Adăugare bloc. Alternativ, puteți tasta / shortcode și apăsați Enter.

Veți observa că, spre deosebire de alte blocuri obișnuite, blocul shortcode nu include setări specifice în bara de instrumente block sau în bara laterală a editorului, probabil datorită faptului că codurile scurte pot fi personalizate folosind atributele lor.

Ce înseamnă Editorul de blocuri pentru codurile scurte WordPress?

Editorul de blocuri WordPress are implicații majore pentru codurile scurte. Să acoperim câteva dintre cele mai importante lucruri de reținut despre codurile scurte WordPress în era editorului de blocuri.

1. Editorul de blocuri WordPress modifică fundamental nevoia și scopul codurilor scurte pentru majoritatea pluginurilor și temelor. Cu un sistem de editare bazat pe blocuri, fiecare „element” de pe pagină are propriul bloc, mai degrabă decât să fie conținut într-un editor WYSIWYG editabil.

Deoarece editorul de blocuri este o abordare total diferită a compunerii unei postări sau pagini, părțile mai dinamice ale unei pagini generate de coduri scurte pot exista ca blocuri care pot fi adăugate individual.

2. Blocurile pot înlocui acum majoritatea codurilor scurte, eliminând necesitatea ca utilizatorii să învețe cum să folosească codurile scurte. Conceptul și formatul codurilor scurte pot avea o curbă de învățare abruptă pentru unii utilizatori, astfel încât abordarea în bloc poate fi mai ușoară.

De exemplu, luați pluginul Gravity Forms. Înainte de editorul de blocuri, procesul de inserare a unui formular într-o postare sau pagină era diferit. Din editorul clasic, a trebuit să utilizați un buton pentru a insera un formular în conținutul dvs.

După selectarea formularului, codul scurt al formularului a fost adăugat la conținutul dvs. În funcție de opțiunile selectate, codul scurt conținea atributele pentru titlu și descriere.

Acum, pluginul Gravity Forms oferă un bloc de forme k bloc încorporat. Din editorul de blocuri, selectați blocul Formulare.

După ce ați selectat formularul, veți vedea de fapt o previzualizare mai bună a modului în care va arăta formularul pe pagina dvs. Setările formularului pot fi găsite în setările blocului.

3. Dezvoltatorii de teme și pluginuri vor trebui să decidă cu privire la viitorul implementărilor lor shortcode și convertirea codurilor lor scurte în blocuri. După cum s-a menționat mai sus, sute de teme, pluginuri și dezvoltatori folosesc în continuare coduri scurte pe site-urile și aplicațiile lor. Adoptarea blocurilor poate fi lentă, dar pe măsură ce utilizatorii devin mai familiarizați cu noul editor de blocuri, este probabil ca utilizatorii să solicite o opțiune de blocare.

Pentru acei dezvoltatori care sunt încă la câțiva kilometri distanță de adoptarea sistemului de editare a blocurilor WordPress, conceptul de editare completă a site-ului poate merge mână în mână cu codurile lor scurte. Plugin-uri precum plugin-uri de recenzie și evaluare, playere audio, bifatori de date, galerii, formulare de contact și multe altele care folosesc în continuare coduri scurte sunt încă „în joc”.

4. Codurile scurte nu vor dispărea în curând. De aceea, editorul de blocuri WordPress oferă blocul de coduri scurte pentru a ajuta la menținerea utilizării codurilor scurte. Deoarece shortcodes-urile aveau o utilizare și o implementare atât de largi înainte de WordPress 5.0 și editorul de blocuri, este important ca versiunile viitoare ale WordPress să accepte în continuare codurile scurte.

5. Codurile scurte pot fi convertite într-un bloc . Aveți o temă sau un plugin preferat care utilizează coduri scurte? Este probabil ca acele coduri scurte să fie convertite într-un bloc la un moment dat. Dacă sunteți dezvoltator al unui plugin sau temă sau creați site-uri web WordPress și utilizați coduri scurte într-o temă personalizată, este posibil să regândiți codurile scurte ca blocuri.

În secțiunea următoare, vom aborda pe scurt modul de conversie a codurilor scurte WordPress în blocuri WordPress.

Cum se convertesc codurile scurte WordPress în blocuri WordPress

La fel cum puteți adăuga coduri scurte personalizate și blocuri reutilizabile, puteți converti cu ușurință codurile scurte personalizate WordPress în blocuri WordPress.

Urmați primii pași din acest ghid personalizat pentru coduri scurte.

Luați acest exemplu de bază din Caldera Forms:

 <?php /** * Handler for [cl_post_title] shortcode * * @param $atts * * @return string */ function caldera_learn_basic_blocks_post_title_shortcode_handler($atts) { $atts = shortcode_atts([ 'id' => 0, 'heading' => 'h3', ], $atts, 'cl_post_title'); return caldera_learn_basic_blocks_post_title($atts[ 'id' ], $atts[ 'heading' ]); } /** * Output the post title wrapped in a heading * * @param int $post_id The post ID * @param string $heading Allows : h2,h3,h4 only * * @return string */ function caldera_learn_basic_blocks_post_title($post_id, $heading) { if (!in_array($heading, ['h2', 'h3', 'h4'])) { $heading = 'h2'; } $title = get_the_title(absint($post_id)); return "<$heading>$title</$heading>"; } /** * Register Shortcode */ add_shortcode('cl_post_title', 'caldera_learn_basic_blocks_post_title_shortcode_handler');

Acest cod preia ID-ul postării și un nivel de titlu (h2, h3, he) și scoate titlul postării înfășurat în codul HTML pentru titlu.

Odată ce ați terminat și ați testat că codul funcționează, trebuie să înregistrați codul scurt ca bloc. Iată Ghidul pas cu pas pentru a converti un cod scurt WordPress într-un bloc Gutenberg, ca exemplu.

Mai multe resurse despre crearea blocurilor WordPress

Există numeroase pluginuri și resurse disponibile online care vă vor ajuta să ajungeți la acel pas, inclusiv documentația oficială de la WordPress despre scrierea primului dvs. tip de bloc. Puteți consulta postarea lui Igor Benic și despre cum să creați un bloc pentru afișarea postărilor.

După ce citiți aceste ghiduri, veți putea afla cum să vă creați propriile blocuri WordPress folosind codurile scurte personalizate.

Verdictul pentru codurile scurte WordPress

Codurile scurte WordPress sunt și vor fi în continuare una dintre cele mai importante părți ale WordPress. Codurile scurte au ajutat mulți dezvoltatori de pluginuri să-și facă pluginurile mai ușor de utilizat și o mulțime de dezvoltatori de teme extind funcționalitățile temelor lor. Codurile scurte au redus, de asemenea, numărul de dureri de cap pe care mulți creatori de conținut și proprietarii de site-uri web le au după ce și-au creat codurile scurte personalizate atunci când vine vorba de adăugarea și actualizarea în mod repetat a lucrurilor dorite.

Acestea fiind spuse, nu există nicio îndoială că editorul de blocuri este viitorul experienței de editare WordPress, așa că așteptați să vedeți că mai mulți dezvoltatori contribuie la îmbunătățirea și chiar mai mult, cu caracteristici pline, inclusiv pe cei care încă folosesc coduri scurte. Privind în viitor, ne așteptăm ca mai mulți dezvoltatori să treacă la utilizarea și adăugarea blocurilor WordPress în loc de coduri scurte WordPress.

Sperăm că ați aflat multe despre importanța codurilor scurte WordPress, la ce servesc și când să le folosiți. Sperăm că puteți începe să creați propriile coduri scurte personalizate și, eventual, propriile blocuri, ambele cu siguranță nu vor dispărea în curând.

Kristen Wright

Kristen a scris tutoriale pentru a ajuta utilizatorii WordPress din 2011. De obicei, o puteți găsi lucrând la articole noi pentru blogul iThemes sau dezvoltând resurse pentru #WPprosper. În afara muncii, Kristen se bucură de jurnal (a scris două cărți!), Drumeții și camping, gătit și aventuri zilnice cu familia ei, sperând să ducă o viață mai prezentă.