Интеграция с WordPress

Този вариант е подходящ, ако сайтът ви е на WordPress и искате да управлявате уеб компонента от админ панела, с shortcode-и или с комбинация от двете, без да поддържате собствен JavaScript за всяка страница.

Какво ви е нужно

• Администраторски достъп до WordPress.
• Активни онлайн резервации за обекта.
• Правилен slug за профила или обекта, който ще показвате.

Инсталирайте плъгина

Най-бързият вариант е:

1. Влезте в WordPress администрацията.
2. Отворете Plugins -> Add New.
3. Потърсете Reservation.Studio Widget.
4. Инсталирайте и активирайте плъгина.
5. Отворете менюто RS Widget.

Ако е нужно, можете да качите плъгина и като ZIP файл през Upload Plugin.

Изберете правилния WordPress подход

Плъгинът покрива три различни начина на работа:

• Глобални настройки в RS Widget: един общ прозорец за резервации за целия сайт.
• Shortcodes: отделни бутони, линкове или вграден iframe за конкретни страници.
• Ръчно писан shortcode: когато искате да контролирате атрибутите директно в съдържанието или шаблона.

Най-често:

• ако искате един общ бутон за целия сайт, започнете с RS Widget;
• ако искате различни страници да водят към различни обекти, профили или категории, използвайте shortcode-и;
• ако искате резервациите да се виждат директно в страницата, използвайте [reservation_studio_embed].

Настройте общия прозорец на уеб компонента

В страницата RS Widget настройвате общата конфигурация на прозореца за сайта:

• Enable widget
• Page type
• Slug
• Language

След това, при нужда, можете да добавите:

• плаващ бутон;
• размер на прозореца;
• CSS селектор за елементи, които ще отварят уеб компонента.

Този екран е най-подходящ, когато искате един общ прозорец за резервации за сайта, управляван от WordPress настройките.

Какво означават основните полета

• "Page type" определя какво ще се отваря: профил на обект, каталог с услуги, групови занимания или бизнес профил.
• "Slug" определя кой точно профил ще се отвори.
• "Language" поддържа "Auto detect", "English" и "Bulgarian".
• "Enable widget" включва глобалния прозорец на уеб компонента за сайта. Ако е изключено, shortcode-ите за вграждане пак могат да работят, но глобалният прозорец няма да се инициализира.

Важно:

• в глобалния екран с настройки "Page type" не предлага отделна стойност за location_service_category;
• ако ви трябва точно страница за категория услуги, използвайте генератора на shortcodes или ръчно написан shortcode с нужните атрибути.

Настройките за плаващия бутон, CSS селектора и размерите на прозореца се пазят тук, защото засягат общия прозорец на уеб компонента. Подробното описание на тези полета е в Интеграция чрез JavaScript, където е събрана и общата конфигурация.

Използвайте shortcode-и за конкретни страници и бутони

Ако искате различни страници или бутони да отварят различни цели, използвайте RS Widget -> Shortcodes.

Това е вградена страница в самия плъгин, не външен инструмент. В WordPress администрацията тя се добавя като отделно подменю под "RS Widget" и отваря екрана за генериране на shortcodes.

Плъгинът поддържа три shortcode варианта:

• [reservation_studio_button]
• [reservation_studio_anchor]
• [reservation_studio_embed]

Важно:

• button и anchor отварят уеб компонента в прозорец;
• embed зарежда съдържанието като iframe направо в страницата;
• embed не използва отваряне в прозорец. Резервациите се показват директно в съдържанието на страницата.

Какво можете да променяте на ниво shortcode

На ниво shortcode можете да зададете:

• slug
• page_type
• language
• utm
• class

Допълнително:

• за бутон и линк: label
• за embed: width, height, loading, title

Ако shortcode тялото съдържа текст, той се използва като видим етикет. Атрибутът label е полезен, когато shortcode-ът е кратък и без собствено съдържание.

Практически това значи:

• генераторът на shortcodes ви дава бърз изходен код, без да помните всички атрибути;
• ръчният shortcode е по-удобен, ако го слагате в конструктор на страници, шаблон или персонализиран блок;
• предварителният преглед в генератора нарочно пропуска атрибути, които са същите като текущите глобални настройки или стандартните стойности.

Какво има в генератора на shortcodes

Вградената страница RS Widget -> Shortcodes ви дава:

• избор на shortcode тип: button, anchor или embed;
• избор на цел за резервация чрез "Slug" и "Page type";
• избор на език;
• отделни полета за UTM source, UTM medium, UTM campaign, UTM content, UTM term;
• опции за визуализиране като допълнителни CSS класове;
• поле "Label" за shortcode-и, които отварят прозорец;
• отделни embed полета за width, height, loading и title;
• готов предварителен преглед "Generated shortcode" и бутон за копиране.

Това е най-бързият начин за разработчик или редактор на съдържание да сглоби работещ shortcode, без да помни всички атрибути наизуст.

Важно:

• [reservation_studio_button] и [reservation_studio_anchor] използват същия механизъм за отваряне на уеб компонента в прозорец;
• [reservation_studio_embed] не отваря прозорец и рендерира iframe директно в страницата;
• ако искате да работите със собствени елементи за отваряне и data-* заместващи стойности, това е описано в Интеграция чрез JavaScript.

Примери

Глобален прозорец от админ панела

Използвайте RS Widget, ако искате:

• един общ бутон за сайта;
• една обща цел, например каталог с услуги на основен обект;
• управление на размера на прозореца и плаващия бутон само от WordPress.

Бутон с текст в shortcode тялото

[reservation_studio_button slug="my-location" page_type="location_profile"]Book now[/reservation_studio_button]

Тук видимият текст е Book now, защото е подаден между началния и затварящия shortcode таг.

Бутон с атрибут label

[reservation_studio_button slug="my-location" page_type="location_profile" language="en" label="Book now"]

Този вариант е удобен, ако искате кратък shortcode без затварящ таг.

Линк с UTM параметри

[reservation_studio_anchor slug="my-location" page_type="location_services" class="my-booking-link" utm='{"source":"newsletter","medium":"email","campaign":"spring"}']Book via link[/reservation_studio_anchor]

Вграден iframe за категория услуги

[reservation_studio_embed slug="my-location" page_type="location_service_category" language="en" height="760" class="booking-frame"]

Този вариант:

• не отваря уеб компонента в прозорец;
• рендерира iframe направо в страницата;
• е подходящ за целева страница, отделна страница за резервации или секция в конструктор на страници.

Как да изберете правилния WordPress подход

• Използвайте RS Widget глобалните настройки, когато искате един общ прозорец за резервации за целия сайт.
• Използвайте shortcode бутон или линк, когато различни страници трябва да отварят различни обекти, различен page_type или различен език.
• Използвайте [reservation_studio_embed], когато искате онлайн резервациите да се виждат директно в страницата, а не в прозорец.

Свързани теми

• Интеграция чрез JavaScript