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

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

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

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

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

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

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

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

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

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

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

Най-често:

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

Настройте общия modal widget

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

• Enable widget
• Page type
• Slug
• Language

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

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

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

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

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

Важно:

• в глобалния settings екран Page type не предлага отделна стойност за location_service_category;
• ако ви трябва точно страница за категория услуги, използвайте shortcode generator или manual shortcode override.

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

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

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

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

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

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

Важно:

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

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

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

• slug
• page_type
• language
• utm
• class

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

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

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

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

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

Какво има в shortcode generator-а

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

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

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

Важно:

• [reservation_studio_button] и [reservation_studio_anchor] използват modal widget runtime-а;
• [reservation_studio_embed] не отваря modal и рендерира iframe директно в страницата;
• ако искате да работите с custom trigger елементи и data-* override-и, това е описано в Интеграция чрез JavaScript.

Примери

Глобален modal widget от админ панела

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

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

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

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

Тук видимият текст е Book now, защото е подаден между opening и closing shortcode tag-а.

Бутон с 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"]

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

• не отваря modal widget;
• рендерира iframe направо в страницата;
• е подходящ за landing page, отделна booking страница или секция в page builder.

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

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

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

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