Шорткодове и уиджети

Как да поставите JetBookIn на сайта си: всеки шорткод и уиджет за Elementor с всичките му опции, на коя страница да стои, как да го съобразите с цветовете на марката си, как работят многоезичните сайтове и – за разработчици – REST API, hooks и командите за WP-CLI.

Страниците, които ви трябват

Типичният сайт с JetBookIn има следните страници. Всеки блок може да се постави с шорткод (във всяка тема или редактор) или със съответния уиджет за Elementor.

Настройката за малка вила с три апартамента може да е съвсем проста: начална страница с банера с търсене и решетката със стаи, по една страница за всеки апартамент (създадена автоматично) и страницата за потвърждение. Хотел с 20 стаи обикновено добавя страница Резервация с резултатите, така че търсенето от всяка страница да води там.

Страници за потвърждение на резервацията и за плащане

Две настройки в JetBookIn → Настройки → Общи казват на JetBookIn къде да отиват гостите:

Страницата за потвърждение показва, в зависимост от това как е отворена: плащането за престой, избран в полето за резервация; резервацията на госта (от връзка с номера на резервацията и ключ); или формуляра Намерете резервацията си. Никога не ви трябва повече от една такава страница за език. Какво могат да правят гостите там, е описано в Страницата на госта за резервацията.

За да намерите ID на страница, отворете я в Страници; числото след post= в адресната лента е ID.

Темите могат да оформят страницата около резервацията с два класа на body: jbi-is-checkout, докато гостът още резервира, и jbi-is-booking, щом има резервация за показване – например за да скрият заглавие „Благодарим ви“ по време на плащането.

Шорткодове за резервации

Тези блокове са интерактивни: зареждат наличността и цените на живо и изискват JavaScript (посетителите без него виждат Моля, включете JavaScript, за да резервирате онлайн.). При атрибутите yes/no всичко различно от no се приема за „да“.

[jetbookin_search] – формуляр за търсене

Дати и гости, след това бутон за търсене. Без страница с резултати резултатите се отварят под формуляра.

[jetbookin_search results_url="/book/" button="Check availability"]

[jetbookin_results] – резултати от търсенето и плащане

Изброява типовете стаи, свободни за избраните дати, с техните тарифи, позволява на госта да избере една или повече стаи и води плащането. Ако няма нищо свободно, предлага други дати.

[jetbookin_booking] – поле за резервация на стая

Календар, гости, тарифи и цена за един тип стая. Резервирай продължава на страницата за плащане с попълнен престой.

[jetbookin_booking room="42" months="2"]

[jetbookin_calendar] – календар на наличността

[jetbookin_confirmation] – потвърждение / управление на резервация

Без атрибути. [jetbookin_manage] прави точно същото. Поставете го само на една страница (за език) и задайте тази страница като ID на страницата за потвърждение на резервацията.

[jetbookin_search_hero] – банер на цялата ширина с търсене

[jetbookin_search_hero image="https://example.com/wp-content/uploads/pool.jpg" heading="Three stone houses above Elounda" subheading="Book direct for the best price" results_url="/book/"]

Шорткодове за стаи и обекти

Те се изобразяват на сървъра (добре за скоростта и за търсачките). Когато атрибут приема тип стая, без него се използва типът стая, чиято страница се показва; атрибутите за обект използват текущия обект, обекта на текущата стая или първия ви обект.

Когато блок няма какво да покаже (няма снимки, удобства…), гостите не виждат нищо; влезлите служители и редакторът на Elementor виждат подсказка какво да попълнят.

[jetbookin_rooms] – решетка или карусел със стаи

[jetbookin_rooms layout="carousel" columns="3" orderby="price" amenities="0"]

[jetbookin_room_gallery]

[jetbookin_room_amenities]

[jetbookin_room_specs]

[jetbookin_room_price]

Най-ниската цена на нощувка от вашите тарифи, напр. от €95 / нощувка.

[jetbookin_room_policies]

[jetbookin_property_info]

Шорткодове за отзиви Pro

И двата изискват модула „Отзиви от гости“; когато той е изключен, не показват нищо.

[jetbookin_reviews] – публикувани отзиви

Средната оценка с нейния етикет (напр. Отличен), карти на отзивите с вашите отговори, бутон Покажи още отзиви и данни за оценката по schema.org за търсачките.

[jetbookin_reviews limit="3" bars="yes" empty="Be the first to review your stay."]

[jetbookin_review] – формуляр за отзив

Без атрибути. Нужен е само ако искате гостите да оставят отзив на отделна страница: поставете го там и въведете ID на страницата като ID на страницата за отзиви в Резервации → Отзиви. Иначе гостите оставят отзив на страницата за потвърждение на резервацията. Формулярът се отваря от подписаната връзка в имейла с поканата за отзив.

Страници за почистване и за собственици Pro

• [jetbookin_housekeeping] (модул „Почистване“): дневният списък за почистване на телефона, за влезли потребители с ролята Камериерка и за мениджърите резервации. Останалите са помолени да влязат или им се казва, че нямат достъп. Камериерките се изпращат на тази страница след влизане.
• [jetbookin_owner] (модул „Собственици и отчети“): месечните отчети и календарът на заетостта на собственика, за влезли потребители с ролята Собственик на обект, свързани с обект. Собствениците се изпращат тук след влизане вместо в wp-admin.

Нито един от тях няма атрибути. И двете страници автоматично се изключват от кеширането на страници. Създайте всяка като обикновена публикувана страница в WordPress.

Страници на стаите без конструктор на страници

Всеки тип стая има собствена страница на сайта ви. Ако не е направена с Elementor, JetBookIn сам я превръща в пълна страница на стаята: галерия със снимки (мозайка от пет снимки), гости / легла / площ, цената „от“, вашето описание, удобства, правила и полето за резервация – до подробностите на широки екрани и под тях на телефони.

Ако съдържанието на стаята вече съдържа шорткод [jetbookin_room_…], накрая се добавя само полето за резервация; ако съдържа [jetbookin_booking], не се добавя нищо. С Elementor създайте единичен шаблон за типовете стаи в Theme Builder и използвайте уиджетите за стаи с — Текущ тип стая —.

Уиджети за Elementor

В редактора на Elementor потърсете JetBookIn или отворете категорията JetBookIn в панела с уиджети. Всеки уиджет изобразява точно същия блок като своя шорткод.

Настройки на съдържанието

Колоните се приспособяват към устройството: по подразбиране 3 на компютър, 2 на таблет и 1 на телефон, като можете да зададете всяко устройство поотделно.

Настройки на стила

Всеки уиджет на JetBookIn има секция Цветове и форма в раздела „Стил“:

• Основен (бутони, избор), Текст на бутоните, Фон, Текст, Рамки – цветове;
• Заобляне на ъглите – от 0 до 24 px;
• Типография – шрифт, размер, дебелина и т.н. за целия уиджет.

Някои уиджети имат още:

• Стаи – решетка / карусел: Карта (Фон, Сянка, Вътрешен отстъп), Заглавие на стаята и Цена (типография и цвят).
• Удобства в стаята: Икони (Цвят, Размер).
• Цена на стаята от: Цена (типография и цвят).
• Банер с търсене: Заглавие и Подзаглавие (типография и цвят).
• Отзиви: Заглавие на отзива и Текст на отзива (типография и цвят).

Съвет: задайте един и същ основен цвят на уиджетите за резервации на страницата. Бутонът Завършете резервацията, който се появява при неплатени резервации, взема цветовете, ъглите и шрифта си от уиджета за резервации на страницата.

Цветове и оформление

Всички блокове на JetBookIn четат цветовете и формите си от CSS променливи, зададени на обвивката .jbi-widget. Настройките на стила в Elementor задават същите променливи. Без Elementor ги задайте в Външен вид → Персонализиране → Допълнителен CSS или в стиловия файл на темата си.

Променливите са дефинирани върху самия .jbi-widget, затова ги задавайте със селектор, който е поне толкова силен, например:

/* Морскосини бутони, прави ъгли, навсякъде */
body .jbi-widget {
	--jbi-primary: #0e5e6f;
	--jbi-on-primary: #ffffff;
	--jbi-radius: 4px;
}

/* Тъмно поле за резервация само в една секция */
.booking-dark .jbi-widget {
	--jbi-surface: #1f1d1a;
	--jbi-surface-2: #2a2723;
	--jbi-text: #f4f1ea;
	--jbi-muted: #b9b4aa;
	--jbi-border: #3a3631;
}

Задаването на променливите само върху body или :root няма ефект, защото .jbi-widget задава свои стойности по подразбиране.

Многоезични сайтове (Polylang, WPML)

JetBookIn работи с Polylang и WPML. Преводите на тип стая или обект са същата стая: те споделят наличност, цени, резервации, галерията и основното изображение. Гостите виждат всичко на езика на страницата, от която резервират, и получават имейлите и страницата на резервацията си на този език.

Какво да преведете

• Типовете стаи и обектите: преведете ги с многоезичния си плъгин (заглавие, описание, откъс). В превода на обекта пишете и неговите инструкции за настаняване на този език.
• Страницата за потвърждение на резервацията и, ако използвате такава, страницата за резервация / плащане: създайте превод на всяка със същия шорткод или уиджет. В „Настройки“ се въвежда само ID на оригинала; JetBookIn изпраща гостите към превода на техния език.
• Страниците с общите условия и с политиката за поверителност и страницата за отзиви: преведете ги по същия начин. Страницата за плащане отваря версията на езика на госта.
• Страниците с търсене, стаи и отзиви: преведете ги като обикновени страници; шорткодовете и уиджетите остават същите.

Ако една страница няма превод, се използва оригиналът.

Имена, които въвеждате в таблото

Имената на тарифните планове, допълнителните услуги (име и описание), промоциите, собствените такси и данните за банков превод се регистрират като низове: в Polylang в Languages → Translations (група JetBookIn), в WPML в String Translation (домейн JetBookIn). Тарифните планове, допълнителните услуги и промоциите имат и полета На други езици точно под името си в таблото; двете места остават синхронизирани. Празен превод показва оригинала.

Имейли

Текстовете на имейлите се редактират за всеки език в Настройки → Имейли, а не с многоезичния плъгин. Вижте Имейли → Отделен текст за всеки език.

За разработчици: REST API

Всичко, което прави таблото, минава през REST API в пространството от имена jetbookin/v1, напр. https://example.com/wp-json/jetbookin/v1/availability/search. Крайните точки за персонала изискват влязъл потребител с правото manage_jetbookin (администраторите и ролята Мениджър резервации) – бисквитка с REST nonce или Application Password за приложения и други сървъри. По-натоварените публични крайни точки (плащане, оферти за цена, действия на гостите, отзиви) имат ограничение на броя заявки за всеки клиент.

Основни публични крайни точки

Крайните точки за персонала включват /bookings (списък, създаване, PUT /bookings/{id}, отмяна, плащания, заявки за плащане, съобщения), /calendar, /quote, /settings, /emails, /reviews и /ical/connections. Доставчиците на плащания извикват собствени маршрути за уебхукове в същото пространство от имена.

За разработчици: hooks

Всички hooks на JetBookIn започват с jbi/. Използвайте ги от малък плъгин или от functions.php на дъщерната си тема.

Действия (actions)

Филтри (filters)

// Две неплатени резервации на имейл адрес.
add_filter( 'jbi/max_open_holds', fn() => 2 );

// Изпращане на всяка потвърдена резервация към друга система.
add_action( 'jbi/booking_confirmed', function ( array $booking ) {
	wp_remote_post( 'https://example.com/hook', [ 'body' => [ 'ref' => $booking['ref'] ] ] );
} );

// Стаите са хотелски стаи за търсачките.
add_filter( 'jbi/structured_data_room_type', fn() => 'HotelRoom' );

Фиксираните имейли с известия могат да бъдат заменени, като копирате admin-conflict.php, admin-sync-failing.php или admin-late-payment.php в yourtheme/jetbookin/emails/.

За разработчици: WP-CLI

На реални сайтове се препоръчва истински cron на сървъра вместо cron на WordPress, който се задейства от посетителите, например на всеки 5 минути:

*/5 * * * * cd /path/to/wordpress && wp jetbookin run-jobs --quiet

Вижте Разширени настройки за фоновите задачи.

Въпроси

Полето за резервация не показва нищо.

Извън собствената страница на типа стая то изисква room="ID" (в Elementor: изберете типа стая). Проверете също дали типът стая е публикуван и има тарифи.

Търсенето изпраща гостите на грешна страница.

Задайте results_url на търсенето (или Страница с резултати в уиджета) към страницата с [jetbookin_results]. Без него резултатите се отварят под формуляра.

Цветовете ми не се променят.

Задайте променливите върху .jbi-widget (например body .jbi-widget { … }), а не само върху body или :root. След това изчистете кеша на CSS или на плъгина за оптимизация.

Мога ли да използвам шорткодовете в Gutenberg, Divi или Bricks?

Да. Добавете блок „Кратък код“ (или елемента за шорткод на вашия конструктор) и поставете шорткода.

Трябва ли ми отделна страница за плащане?

Не. Ако ID на страницата за плащане е празно, полето за резервация продължава на страницата за потвърждение на резервацията. Отделна страница „Резервация“ с резултатите е полезна, когато искате и страница за търсене.

Изтрих по погрешка страницата за потвърждение на резервацията.

Създайте страница с [jetbookin_confirmation], публикувайте я и въведете ID ѝ като ID на страницата за потвърждение на резервацията в Настройки → Общи. Връзките в изпратените по-рано имейли още сочат към стария адрес, затова при нужда изпратете отново на засегнатите гости връзката към резервацията им.