Редактор на код за отпечатани разписки за Вашия Shopify POS
Можете да персонализирате своите отпечатани разписки, като използвате редактора на код във Вашия администраторски панел на Shopify. Файловете, които съставляват Вашите разписки, съдържат Liquid – езика за шаблони на Shopify. С редактора на код можете да създавате по-разширени персонализации, използвайки HTML, CSS и Liquid, отколкото с визуалния редактор.
Можете да променяте шаблона за разписка и шаблоните за секции, използвани във Вашите отпечатани разписки. Файловете с шаблони за Разписки са типовете разписки, които можете да отпечатате в магазина си. Секциите са части от разписките, като например заглавката или долния колонтитул. Секциите могат да се използват повторно от множество разписки.
На тази страница
- Съображения относно използването на редактора на код за разписки
- Достъп до редактора на код
- Използване на персонализирани файлове във Вашия шаблон за разписки
- Нулиране на Вашия шаблон за разписки
- Променливи на Liquid, налични в редактора на код за разписки
- Филтри на Liquid, налични в редактора на код за разписки
- Пример за персонализиране на кода на шаблон за отпечатана разписка
- Визуализация на промените в кода Ви в редактора на код
Съображения при използването на редактора на код за разписки
Преди да използвате редактора на код за разписки, прегледайте следните съображения:
Ограничения за достъп
- Можете да използвате редактора на код само от администраторския си панел на Shopify на настолен компютър.
- Редакторът на код не е наличен за никое местоположение на POS в Италия.
Къде се прилагат промените
- Промените в кода, които правите, се прилагат само за избраното местоположение.
- Персонализациите в редактора на код се прилагат само за местоположения с POS Pro. Ако използвате редактора на код и имате местоположения без POS Pro, тогава можете да използвате визуалния редактор, за да персонализирате заглавката и долния колонтитул за тези местоположения.
- Можете да персонализирате отпечатаните разписки, които имат шаблон в редактора на код, като например разписки за продажби, разписки за подаръци, разписки за подаръчни карти и разписки за връщания и замени.
Езици на кода
- Файловете, които съставляват Вашите разписки, съдържат Liquid – езика за шаблони на Shopify. Научете повече за използването на Liquid.
- За да редактирате шаблоните в редактора на код за разписки, трябва да сте запознати с HTML, CSS и Liquid. Поддръжката за теми на Shopify може да помогне с незначителни корекции в рамките на Политиката за дизайн на Shopify.
Ограничения за персонализиране
- Не можете да визуализирате разписки в различни размери на принтера от редактора на код. За да визуализирате по размер на принтера, използвайте визуалния редактор.
- Описанията на продуктите не са налични като променлива в шаблоните на разписки и не могат да се добавят към отпечатаните разписки.
Поддръжка на шаблони
- Ако персонализирате разписка чрез редактора на код за разписки, във Вашия съществуващ шаблон може да липсват нови свойства, като например
selling_plan_name. За да добавите най-новите налични свойства към своя шаблон, трябва да нулирате шаблона си за разписки до този по подразбиране. Нулирането на шаблони за разписки до тези по подразбиране премахва всяко персонализиране, което сте направили по тях. Запишете си персонализирания код, преди да нулирате. След като нулирате шаблона, трябва ръчно да приложите отново своето персонализиране.
Достъп до редактора на код
Можете да редактирате своите шаблони, като използвате редактора на код. Първо трябва да преминете към използване на редактора на код от визуалния редактор по подразбиране, като можете да се върнете към визуалния редактор по всяко време.
Стъпките за превключване между редакторите се различават леко в зависимост от това дали всички Ваши местоположения на POS отговарят на условията за редактора на код, или само някои от тях отговарят на тези условия (например някои от Вашите местоположения на POS не използват POS Pro или се намират в Италия или Франция).
Стъпки:
Всички местоположения с POS Pro
От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.
В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.
Кликнете върху иконата
в лявата странична лента.
Кликнете върху Редактиране на код.
В диалоговия прозорец Редактиране на код за отпечатани разписки редактирайте кода, който искате да промените.
Кликнете върху Запазване.
По желание: За да продължите да редактирате още страници на Shopify POS с помощта на редактора на POS, върнете се назад в прозореца на браузъра си.
С местоположения Lite или в Италия
От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.
В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.
На страницата Персонализиране на разписка кликнете върху Редактор на код.
Използване на персонализирани файлове във Вашия шаблон за разписка
Можете да използвате файлове, като например файлове с изображения, които качвате във Вашия администраторски панел на Shopify, за да персонализирате отпечатаните си разписки.
Преди даден файл да може да бъде използван в отпечатана разписка, той трябва да бъде качен във Вашия администраторски панел на Shopify. Научете повече за качването на файлове.
Стъпки:
От Вашия администраторски панел на Shopify отидете на Съдържание > Файлове.
До файла, който искате да включите в кода на отпечатаната си разписка, кликнете върху
, за да копирате връзката.
Включете връзката към ресурса във Вашия шаблон.
Нулиране на шаблона за разписка до настройките по подразбиране
Можете да нулирате шаблон за разписка до версията по подразбиране с помощта на редактора на код.
Стъпки:
Всички местоположения с POS Pro
От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.
В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.
Кликнете върху Персонализиране на Вашите разписки.
Кликнете върху Редактиране на код.
Кликнете върху файла с код, който искате да нулирате.
Кликнете върху иконата
.
В диалоговия прозорец Нулиране на файла до настройки по подразбиране кликнете върху Нулиране.
С местоположения Lite или в Италия
От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.
В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.
На страницата Персонализиране на разписка кликнете върху Редактор на код.
Кликнете върху файла с код, който искате да нулирате.
Кликнете върху иконата
.
В диалоговия прозорец Нулиране на файла до настройки по подразбиране кликнете върху Нулиране.
Променливи на Liquid, налични в редактора на код за разписки
Можете да използвате Liquid, за да персонализирате своя шаблон за отпечатани разписки и типовете разписки.
Следните обекти с данни са налични за редактора на код за разписки:
Обекти на разписка
| Обект | Описание |
|---|---|
shop | Съдържа информация за магазина, като например името на магазина. |
location | Съдържа информация за местоположението на магазина за търговия на дребно, като например адрес и телефонен номер. |
order | Съдържа данни за поръчката, включително редовете, отстъпките, данъците и информацията за транзакцията. |
return |
Наличен е само в шаблона return-and-exchange-receipt.liquid и свързаните с него частични шаблони. Съдържа данни за връщане и замяна, включително върнатите редове, новите редове, нетната сума и информацията за транзакцията.
|
gift_card |
Наличен е само в шаблона gift-card.liquid. Съдържа данните за подаръчната карта, включително салдото, буквено-цифровия код и съдържанието на QR код, който може да бъде сканиран от приложението POS.
|
Обект на поръчка
| Свойство | Описание |
|---|---|
id | Идентификатор на поръчката. |
created_at | Форматираните по ISO 8601 дата и час на създаване на поръчката. |
source_identifier | Уникален идентификатор на поръчка от POS или от трета страна. |
change_due | Ресто по поръчката. |
balance_due | Дължима сума по тази поръчка. |
name | Уникалният идентификатор за поръчката, който се показва на страницата на поръчката в администраторския панел на Shopify и на страницата за състоянието на поръчката. Например „#1001“, „EN1001“ или „1001-A“. Тази стойност не е уникална за различните магазини. |
note | Съдържанието на бележката, свързана с поръчката. |
line_items | Списък с редовете на поръчката. |
subtotal_price |
Сумата от цените за всички редове след отстъпките и преди връщанията. Ако taxesIncluded е true, тогава междинната сума включва и данък.
|
total_price | Общата цена на поръчката преди връщанията. Това включва данъци и отстъпки. |
total_tip_received | Сумата на всички бакшиши за поръчката. |
discounts | Общата сума на отстъпките. |
transactions | Списък с транзакциите, свързани с поръчката. |
taxes_included | Дали данъците са включени в междинната сума на поръчката. |
tax_lines | Списък с всички данъчни редове, приложени към редовете на поръчката, преди връщанията. Цените на данъчните редове представляват общата цена за всички данъчни редове със същата ставка и заглавие. |
customer | Клиентът, който е направил поръчката. |
shipping_address | Адресът за доставка на поръчката. |
shipping_groups | Списък с групи за доставка на поръчката. Всяка група съдържа редове, които се изпълняват заедно. |
Обект за връщане
| Свойство | Описание |
|---|---|
name | Уникалният идентификатор за връщането, който се показва на страницата на поръчката в администраторския панел на Shopify и на страницата за състоянието на поръчката. Например „#1000-R1“. Тази стойност не е уникална за различните магазини. |
created_at | Датата и часът във формат ISO 8601, когато е създадено връщането. |
is_unverified | Булева стойност, показваща дали връщането е създадено като Непроверено връщане. |
is_exchange | Булева стойност, указваща дали връщането включва замяна. Това включва възстановявания на суми, направени по подаръчна карта. |
exchange_type |
Типът на замяната, ако връщането включва замяна. Възможните стойности са LIKE_FOR_LIKE, NET_REFUNDABLE и NET_PAYABLE.
|
return_discount | Общата сума на отстъпките за поръчката, която е възстановена. |
return_subtotal |
Сумата от цените за всички редове на връщането преди отстъпките. Ако taxesIncluded е true, тогава междинната сума включва и данък.
|
return_total | Общата възможна сума за възстановяване. Това включва данъци, отстъпки, доставка и бакшиши. Може да не е действително възстановената сума. |
exchange_subtotal |
Сумата от цените за всички нови редове при замяната преди отстъпките. Ако taxesIncluded е true, тогава междинната сума включва и данък.
|
exchange_total | Общата сума за всички нови редове при замяната. Това включва данъци и отстъпки. |
total_cash_rounding_adjustment | Корекцията за закръгляване при плащане в брой, приложена към връщането или замяната. |
total_adjusted_amount | Общата сума за връщането или замяната, коригирана с корекцията за закръгляване при плащане в брой. |
net_total | Действителната обща сума, платена или възстановена за връщането или замяната, преди закръгляването при плащане в брой. |
return_line_items | Върнатите редове. |
exchange_line_items | Новите редове при замяната. |
return_tax_lines | Данъчните редове за върнатите редове. |
exchange_tax_lines | Данъчните редове за новите редове при замяната. |
shipping_refund_amount | Сумата за доставка, която е възстановена. |
tip_refund_amount | Сумата на бакшиша, която е възстановена. |
transactions | Транзакциите, свързани с връщането или замяната. |
Обект на група за доставка
| Свойство | Описание |
|---|---|
destination | Дестинация на продуктите, които се доставят. |
products | Списък с продукти, които се доставят. |
Обект на ред
| Свойство | Описание |
|---|---|
id | Идентификаторът на реда. |
name | Заглавието на продукта, към което по избор се добавя заглавието на варианта (ако е приложимо). |
variant_title | Заглавието на варианта към момента на създаване на поръчката. |
price | Единичната цена на реда, когато е създадена поръчката. Тази стойност не включва отстъпки. |
is_gift_card | Дали редът представлява покупка на подаръчна карта. |
discount | Общата отстъпка, която е разпределена към реда от приложения за отстъпки, включително отстъпки, разпределени към възстановени и премахнати количества. |
total_price | Общата сума за този ред. |
selling_plan_name | Името на абонаментния план, присвоен на реда. |
tax_rates | Данъчните редове за този ред. |
custom_attributes | Списък с атрибути, които представляват потребителски функции или специални заявки. |
variant_title | Алтернативното заглавие. |
variant_id | Идентификаторът на варианта. |
variant_metafields | Списък с потребителски полета, които търговецът е свързал с варианта. |
staff_member_description | Служител от персонала, свързан с реда. |
product_metafields | Списък с потребителски полета, които търговецът е свързал с продукта. |
Обект на ред за връщане
Включва всичко от обекта на реда плюс следните свойства:
| Свойство | Описание |
|---|---|
return_reason | Причината за връщането на реда. |
return_reason_note | Незадължителна бележка към причината за връщане. |
Liquid филтри, налични в редактора на код за разписки
Можете да използвате Liquid филтри, за да правите корекции на информацията във Вашите шаблони за разписки. Например можете да промените форматирането на валутата или използването на главни букви в конкретен текст, като например стандартен данъчен код.
За да приложите филтър, добавете символ за вертикална черта | и след това филтъра в блока с Liquid код между двойни къдрави скоби {{ }}. Филтрите могат да се прилагат само към блокове с Liquid код.
В следващия пример филтърът коригира стандартния данъчен код от малки на главни букви.
{{ tax_line.title | upcase }}В примерния блок с код product е обектът, title е неговото свойство, а upcase е приложеният филтър. Филтърът upcase променя изписването на стойността на tax_line.title с главни букви. Например, ако tax_line.title има стойност Hst, тогава филтърът upcase променя стойността на HST.
Обърнете се към раздел „Филтри“ от справочника за Liquid на Shopify Themes за подробности относно това как да използвате филтрите на Liquid.
В редактора на код на разписка са налични следните филтри:
| Свойство | Описание | |
|---|---|---|
t | Превежда предварително дефинирани етикети на езика, зададен за Вашето местоположение. | |
money | Форматира цената във валутата на Вашето местоположение. | |
escape |
Екранира специални знаци в HTML, като <>, ' и &, и конвертира знаците в екраниращи последователности.
| |
barcode | Генерира 1D SVG баркод. | |
qrcode | Генерира 2D SVG баркод. |
Пример за персонализиране на кода на шаблон за печатна разписка
Можете да използвате Liquid, за да добавяте условни съобщения. Тази функционалност е подобна на запазването в едно местоположение с визуалния редактор. Например Вашият бизнес е стартирал с едно местоположение, а сега имате няколко нови местоположения. Искате да откроите своя оригинален магазин на отпечатаните разписки.
Можете да добавите персонализирано съобщение към шаблона header.liquid в папката Sections на редактора на код и да използвате Liquid, за да покажете съобщението само за основното Ви местоположение.
Следният код проверява името на местоположението, в този случай Вашето първоначално местоположение, наречено „Home“, и показва съобщението „Добре дошли в нашия първоначален магазин, отворен през 1972 г.“, ако местоположението съответства на името. Разписките, отпечатани от другите Ви местоположения, вместо това показват съобщението „Добре дошли в нашия магазин.“.
{% if location.name == 'Home' %}
Welcome to our original store, opened in 1972.
{% else %}
Welcome to our store.
{% end %}Преглед на промените в кода в редактора на код
Можете да прегледате промените в печатните си разписки в редактора на код на POS в администраторския панел на Shopify.
В зависимост от това кой Liquid файл е избран, прозорецът за преглед осветява дизайна или секцията на разписката, засегнати от файла. По подразбиране прозорецът за преглед показва съдържанието за най-скорошната Ви POS поръчка. Можете да изберете конкретна поръчка, която да се използва като съдържание на разписката в прозореца за преглед за всички Liquid файлове с изключение на файла gift-card.liquid, който показва само различните местоположения като опции за преглед, които могат да бъдат избрани.
Стъпки:
Всички местоположения с POS Pro
От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.
В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.
Кликнете върху Персонализиране на Вашите разписки.
Кликнете върху Редактиране на код.
Кликнете върху кодовия файл, който искате да прегледате. Вашата разписка се показва в най-десния прозорец на редактора.
По избор: За да изберете конкретна поръчка, която да се използва като съдържание на разписката в прозореца за преглед, изпълнете следните действия:
- Кликнете върху иконата
.
- Продажбите, направени от канала Point of Sale от всички местоположения, се показват в диалоговия прозорец Избор на поръчка за преглед. Изберете поръчка от списъка или търсете конкретни поръчки и местоположения, като използвате лентата за търсене.
- Кликнете върху Потвърждаване.
- Кликнете върху иконата
По избор: Ако преглеждате файла
gift-card.liquid, кликнете върху иконатаи изберете местоположението, за което искате да прегледате шаблона.
С местоположения Lite или в Италия
От Вашия администраторски панел на Shopify отидете на Точка на продажба > Настройки.
В раздела Персонализиране кликнете върху Отпечатани разписки, за да отворите редактора на POS.
На страницата Персонализиране на разписка кликнете върху Редактор на код.
Кликнете върху кодовия файл, който искате да прегледате. Вашата разписка се показва в най-десния прозорец на редактора.
По избор: За да изберете конкретна поръчка, която да се използва като съдържание на разписката в прозореца за преглед, изпълнете следните действия:
- Кликнете върху иконата
.
- Продажбите, направени от канала Point of Sale от всички местоположения, се показват в диалоговия прозорец Избор на поръчка за преглед. Изберете поръчка от списъка или търсете конкретни поръчки и местоположения, като използвате лентата за търсене.
- Кликнете върху Потвърждаване.
- Кликнете върху иконата
По избор: Ако преглеждате файла
gift-card.liquid, кликнете върху иконатаи изберете местоположението, за което искате да прегледате шаблона.