Wstawki własne

Moduł Wstawki własne znajduje się w Menu CMS  Edycja treści.

image1 b2b
Rysunek 1. CMS – Wstawki własne

Wstawki mogą być wykorzystane do umieszczenia przez operatora sklepu treści statycznej.

Wstawki własne nie są jednoznacznie przypisane do jednego miejsca, (jak ma to miejsce w przypadku wstawek systemowych). Wstawki własne mogą być prezentowane w różnych miejscach w Sklepie:

  • na Stronę główną można dodać panel z pojedynczą Wstawką lub stworzyć Pokaz slajdów ze wstawkami wybierając opcje pod przyciskiem Dodaj pozycję strony głównej (CMS  Układ i wygląd  Strona główna);

  • Można dodać panel ze wstawką do Menu głównego Sklepu wybierając opcję Wstawki dostępną pod przyciskiem Dodaj pozycję menu (CMS  Układ i wygląd  Menu główne);

  • Wstawkę można dodać do Stopki (CMS  Układ i wygląd  Stopka), klikając przycisk Dodaj panel i wybierając Wstawki i zaznaczając wybraną wstawkę;

  • Panel z pojedynczą Wstawką lub Pokaz slajdów ze wstawkami można również umieścić w Panelach (CMS  Układ i wygląd  Panele), najpierw należy dodać Wstawkę/Pokaz slajdów w zakładce Konfiguracja paneli (przycisk Dodaj panel) a następnie w zakładce Rozkład paneli przeciągnąć Wstawkę/Pokaz slajdów do wybranego panela;

Lista Wstawek własnych

Po wejściu do modułu prezentowana jest lista Wstawek własnych zawierająca kolumny: Tytuł, Data obowiązywania od, Data obowiązywania do, Data utworzenia, Data modyfikacji oraz Identyfikator (kolumna domyślnie ukryta). Data modyfikacji aktualizowana jest przy każdym zapisie zmian we wstawce. Jeśli dana wstawka jest nieaktywna, obok jej tytułu wyświetlana jest ikona z literą N na szarym tle. Jeśli natomiast nie nadeszła jeszcze Data obowiązywania od lub minęła już Data obowiązywania do, obok tytułu wyświetlana jest ikona z literą N na szaropomarańczowym tle.

Listę można filtrować m.in. według Tytułu, Treści - filtr pozwala wyszukać wstawki zawierające w treści podany tekst - oraz według Daty obowiązywania od, Daty obowiązywania do, Daty utworzenia i Daty modyfikacji.

Nad listą dostępne są predefiniowane zestawy filtrów (presety): Wszystkie - wszystkie wstawki niezależnie od ich statusu i dat, Widoczne - wstawki aktywne, których data obowiązywania od już nadeszła, a data obowiązywania do jeszcze nie minęła, oraz Niedostępne - wstawki nieaktywne, a także te, których data obowiązywania od jeszcze nie nadeszła lub data obowiązywania do już minęła. Po wejściu do modułu domyślnie wyświetlany jest preset Widoczne.

Obok tytułu danej wstawki widoczna jest ikona wielokropka, pod którą dostępne są opcje: Aktywuj/Dezaktywuj (w zależności od statusu wstawki) oraz Usuń. Wstawki można również usuwać grupowo - po zaznaczeniu ich na liście. Nie można usunąć wstawek powiązanych z Wyskakującymi okienkami - w takim przypadku wyświetlony zostanie komunikat "Nie można usunąć poniższych wstawek własnych, ponieważ są powiązane z wyskakującymi okienkami" wraz z listą tych wstawek, a operacja nie zostanie wykonana.

Po kliknięciu w wiersz listy dane wstawki prezentowane są w panelu bocznym, bez opuszczania listy. W panelu bocznym nie jest prezentowane pole Treść - można je edytować w szczegółach wstawki, a przypisane grupy prezentowane są tylko do podglądu.

image22
Rysunek 2. Lista Wstawek własnych - przykład w Panelu Administracyjnym

Dodawanie nowej Wstawki własnej

Nową wstawkę można dodać za pomocą przycisku Dodaj wstawkę. W oknie dodawania, w sekcji Treść domyślna, należy podać Tytuł oraz Treść wstawki w języku bazowym. Tytuł i treść można podać również w innych językach - jeśli w danym języku zostanie uzupełnione jedno z tych pól, drugie również staje się wymagane. Pole Tytuł może zawierać maksymalnie 255 znaków.

W sekcji Parametry można określić, czy wstawka ma być aktywna, a także Datę od i Datę do, czyli okres wyświetlania wstawki w Sklepie - patrz: Wstawki własne - określanie czasu aktywności.

Data do musi być późniejsza niż Data od.

Treści dedykowane dla Oddziałów kontrahentów można dodać po zapisaniu wstawki, w jej szczegółach.

W oknie dodawania dostępna jest również sekcja Przykładowa treść wstawki z rozwijanymi przykładami: Zapis do newslettera oraz Formularz. Przykład można skopiować za pomocą przycisku Kopiuj do schowka i wkleić do pola Treść. Sekcja dostępna jest także w szczegółach wstawki, w zakładce Dane podstawowe.

image23
Rysunek 3. Dodawanie nowej Wstawki własnej - przykład w Panelu Administracyjnym

Szczegóły Wstawki własnej

Szczegóły wstawki wyświetlane są po kliknięciu w jej tytuł na liście.

Dane podstawowe

W sekcji Dane podstawowe można edytować Status wstawki (Aktywna/Nieaktywna) oraz Datę od i Datę do. Prezentowana jest również Data utworzenia wstawki.

W sekcji Dane opisowe można edytować, osobno dla każdego języka, Tytuł (pole wymagane, maksymalnie 255 znaków) oraz Treść wstawki. Treść edytowana jest w edytorze tekstu sformatowanego. Po wybraniu języka innego niż bazowy dostępna jest opcja Tłumacz z AI, pozwalająca przetłumaczyć tytuł i treść z języka bazowego.

Dodając do wstawki obrazy, warto skorzystać z parametru 'data-src', dzięki czemu wstawka stanie się responsywna. Np. <p><img alt="" data-src="//static.domena.pl/design/accounts/demo/img/bazowy/darmowa-dostawa.png" /></p>
image24 b2b
Rysunek 4. Dane podstawowe w szczegółach Wstawki własnej - przykład w Panelu Administracyjnym

Treści dedykowane

Treść wstawki można spersonalizować dla wybranych Oddziałów kontrahentów. W zakładce Treści dedykowane prezentowana jest lista treści dedykowanych danej wstawki. Nową treść dedykowaną można dodać za pomocą przycisku Dodaj treść dedykowaną - należy uzupełnić jej treść, a następnie wybrać co najmniej jeden Oddział kontrahenta (przycisk Wybierz oddziały), dla którego treść ma być wyświetlana.

Po wybraniu treści dedykowanej z listy można edytować jej Tytuł i Treść w poszczególnych językach - tytuł w danym języku można wpisać dopiero po uzupełnieniu treści w tym języku. W sekcji Powiązane oddziały można zarządzać listą Oddziałów kontrahentów, dla których wyświetlana jest dana treść.

Dla treści dedykowanej dostępne są również opcje:

  • Kopiuj z treści domyślnej - opcja pozwala zastąpić treść dedykowaną treścią domyślną wstawki we wszystkich językach (po potwierdzeniu). Opcja dostępna jest również podczas dodawania nowej treści dedykowanej;

  • Usuń treść - opcja pozwala usunąć treść dedykowaną (po potwierdzeniu).

Zakładka Treści dedykowane dostępna jest dla uprawnionych Operatorów.

image25
Rysunek 5. Treści dedykowane w szczegółach Wstawki własnej - przykład w Panelu Administracyjnym

Grupy oddziałów kontrahentów

W zakładce Grupy oddziałów kontrahentów można zaznaczyć grupy, do których adresowana jest treść domyślna wstawki. Zakładka dostępna jest dla uprawnionych Operatorów.

image26 b2b
Rysunek 6. Grupy oddziałów kontrahentów w szczegółach Wstawki własnej - przykład w Panelu Administracyjnym

Historia zmian

W zakładce Historia zmian można sprawdzić, kto i kiedy zmienił treść wstawki, porównać poszczególne wersje oraz w razie potrzeby przywrócić wcześniejszą wersję treści.

Każdy zapis treści tworzy nową wersję. Historia obejmuje pola Tytuł i Treść. Wersje przechowywane są osobno dla każdego języka - przy nazwie języka prezentowana jest liczba zapisanych wersji. Jeśli dla wstawki zdefiniowano treści dedykowane, w polu Treść można wybrać, której treści dotyczy historia: Treści domyślnej lub wybranej treści dedykowanej.

Na liście wersji prezentowane są: numer wersji (najnowsza oznaczona jest jako Bieżąca), Autor, Zmienione pola oraz Data zmiany. Po kliknięciu w numer wersji wyświetlane są jej szczegóły - lista zmienionych pól z zaznaczonymi różnicami względem poprzedniej wersji. Wcześniejszą wersję można porównać również z wersją bieżącą (opcja Porównaj z).

W szczegółach wcześniejszej wersji dostępny jest przycisk Przywróć wersję. Po potwierdzeniu bieżąca treść zostaje zastąpiona wybraną wersją - przywrócenie tworzy nową wersję, a dotychczasowa treść pozostaje w historii.

Historia przechowuje 50 ostatnich wersji każdej treści, osobno dla każdego języka - starsze wersje są usuwane automatycznie.

image27 b2b
Rysunek 7. Historia zmian w szczegółach Wstawki własnej - przykład w Panelu Administracyjnym

Wstawki własne - określanie czasu aktywności

Możliwe jest określenie czasu wyświetlania Wstawek własnych, dzięki czemu np. informacje o akcjach promocyjnych mogą być wyświetlane w Sklepie tylko w terminie ich obowiązywania. Aby określić termin wyświetlania wstawki w Sklepie, należy podczas jej dodawania lub w jej szczegółach podać Datę od i/lub Datę do wraz z godziną (domyślna godzina dla Daty do to 23:59). Żeby wstawka własna wyświetlała się w Sklepie, musi mieć Status: Aktywna. Nawet jeśli zostaną podane daty wyświetlania wstawki, ale nie będzie ona miała Statusu Aktywna, nie wyświetli się ona w Sklepie. Podobnie, jeśli w trakcie trwania wyświetlania Status wstawki własnej zmieniony zostanie na Nieaktywna, przestanie ona być widoczna w Sklepie, mimo że termin jej wyświetlania nie upłynął. Można również podać tylko Datę od - wówczas wstawka będzie wyświetlać się w Sklepie od podanego terminu do momentu jej dezaktywacji za pomocą Statusu lub tylko Datę do - wówczas wstawka własna będzie widoczna od momentu aktywacji za pomocą Statusu do upływu określonego terminu.

Tworzenie własnych formularzy

Umożliwiono tworzenie własnych formularzy w formie Wstawek własnych/Stron własnych CMS  Edycja treści, które można umieścić w dowolnym miejscu w Sklepie.

Tworzenie Wstawki własnej/Strony własnej zawierającej formularz:

  1. Całość treści formularza należy umieścić pomiędzy znacznikami <form> </form>

  2. Przy otwierającym znaczniku <form> należy umieścić elementy pozwalające na obsługę i wstępne nadanie stylu formularza:

<form class="custom-form module-loader" data-module="message/CustomForm">
  1. W formularzu muszą znaleźć się dwa pola ukryte, w których należy podać temat wiadomości, pozwalający zidentyfikować wiadomości email pochodzące z tego formularza oraz adres email, na który wiadomości te mają zostać wysłane:

<input type="hidden" name="topic" value="Formularz własny">
<input type="hidden" name="mailto" value="email@email.com">
  1. W treści powinien znaleźć się też przycisk pozwalający wysłać formularz:

<button type="submit" title="Wyślij">Wyślij</button>
  1. W przypadku gdy uzupełnienie jakiegoś pola powinno być obowiązkowe, w znaczniku input takiego pola musi znaleźć wartość "required":

<input type="email" name="Email" placeholder="Wpisz adres e-mail" required>
  1. Obsługiwane typy pól: text, email, date, time, color, range, number, checkbox, radio, textarea

Przykładowa treść Wstawki/Strony własnej:

<form class="custom-form module-loader" data-module="message/CustomForm">
    <div>
        <label>E-mail:</label>
        <input type="email" name="Email" placeholder="Wpisz adres e-mail" required="required" />
    </div>

    <div>
        <label>Imię:</label>
        <input type="text" name="Imie" placeholder="Wpisz imię" />
    </div>

    <div>
        <label>Data spotkania:</label>
        <input type="date" name="Data spotkania" />
    </div>

    <div>
        <label>Godzina spotkania:</label>
        <input type="time" name="Godzina spotkania" />
    </div>

    <div>
        <label>Kolor:</label>
        <input type="color" name="Kolor" />
    </div>

    <div>
        <label>Zakres:</label>
        <input type="range" name="Zakres" min="1" max="100" />
    </div>

    <div>
        <label>Ilość:</label>
        <input type="number" name="Ilosc" placeholder="Wpisz liczbę" min="1" max="100" />
    </div>

    <div>
        <label>Checkbox:</label>
        <input type="checkbox" name="Checkbox" value="Tak" /> Tak
    </div>

    <div>
        <label>Radio:</label>
        <input type="radio" name="Radio" value="Opcja 1" /> Opcja 1
        <input type="radio" name="Radio" value="Opcja 2" /> Opcja 2
    </div>

    <div>
        <label>Wiadomość:</label>
        <textarea name="Wiadomość" placeholder="Wpisz uwagi"></textarea>
    </div>

    <input type="hidden" name="topic" value="Przykładowy formularz" />
    <input type="hidden" name="mailto" value="email@email.com" />

    <button type="submit" title="Wyślij">Wyślij</button>
</form>

Przykładowa treść formularza dostępna jest również w sekcji Przykładowa treść wstawki (przykład Formularz) podczas dodawania Wstawki własnej oraz w jej szczegółach - patrz: Dodawanie nowej Wstawki własnej.

Wstawkę własną z formularzem można dodać do CMS  Edycja treści:

  • Strony głównej - Dodaj pozycję strony głównej → Wstawka;

  • Paneli - zakładka: Konfiguracja paneli → Dodaj panel → Wstawki, a następnie w zakładce Rozkład paneli przeciągając dodaną wstawkę do wybranej sekcji/kolumny w układzie podstawowym lub układzie dowolnej strony;

  • Menu głównego - Dodaj pozycję menu → Wstawki

  • Stopki - Dodaj panel → Wstawki.

Link do Strony własnej można dodać do:

  • Menu głównego - Dodaj pozycję menu → Strona;

  • Stopki - Dodaj panel → Odnośniki → Dodaj pozycję panela → Strona;

  • innych miejsc np. w treści opisu.

image5
Rysunek 8. Przykładowa Strona własna z formularzem - widok w Sklepie
Jeśli formularz zostanie uzupełniony i wysłany, jego treść zostanie przesłana na adres e-mail podany podczas jego konfiguracji w polu "mailto".
image6
Rysunek 9. Przykładowa wiadomość e-mail z danymi z formularza