Deprecated: Function create_function() is deprecated in /var/www/sello.pl/wp-content/themes/sello/library/cleanup.php on line 82
Sello | markdown

Sello 1.25 do pobrania

Zmiany w wersja 1.25 skupiają się głównie na nowych opisach Allegro. W programie usunięty został dotychczasowy edytor HTML i zastąpiony został bardziej nowoczesnym rozwiązaniem, mającym dużo większe możliwości.

a

Pliki do pobrania:

Sello 1.25

Dokumentacja bazy danych 1.25
Zmiany w bazie danych 1.24.2-1.25.0

W wersji tej zmianie uległo bardzo wiele mechanizmów w obrębie aukcji, opisu, edycji, obsługi zdjęć itp. Zrealizowaliśmy ponad 150 różnych zagadnień związanych tylko z edycją opisu (jest to niemal 3 razy więcej zagadnień niż zawiera statystyczna wersja Sello).

Przed zainstalowaniem nowej wersji koniecznie należy wykonać kopię zapasową (archiwizację) bazy danych.

PEŁNA LISTA ZMIAN

Zobacz listę wszystkich zmian w wersji

CO NOWEGO?

WAŻNE INFORMACJE – PRZECZYTAJ KONIECZNIE

W związku z wymogami jakie wprowadza Allegro odnośnie nowych opisów instalacja Sello 1.25 będzie niebawem konieczna, aby móc wystawiać aukcje od lutego 2018. Tak dużych zmian w działaniu aplikacji jeszcze w Sello nie było, choć z wierzchu może wydawać się, ze został zmieniony tylko edytor graficzny HTML. Prosimy zatem zgłaszać do nas ewentualne problemy z działaniem edytora oraz wystawiania aukcji.

NOWY EDYTOR OPISU

Wymieniliśmy całkowicie edytor HTML w aukcjach, szablonach aukcji oraz w szablonach opisu. Edytor działa na zupełnie innej zasadzie niż poprzedni, co pociągnęło za sobą konieczność wprowadzenia licznych zmian w module aukcji.

Nowy edytor obsługuje zarówno tryb HTML jak i nowy, blokowy opis Allegro. W tym celu powstały dwa osobne zmodyfikowane odpowiednio wersje edytora dostosowane odpowiednio do potrzeb serwisu. Sello na podstawie zapisanego opisu w bazie danych uruchamia edytor HTML lub edytor blokowy (może się pojawić tutaj również określenie edytor JSON (czyt. dżejson) – związane jest to z formatem zapisu nowego opisu przez Allegro).

EDYTOR HTML I EDYTOR BLOKOWY

Pomiędzy edytorami można się przełączać na zakładce OPIS w oknie aukcji. Na poniższym obrazku znajduje się porównanie wyglądu obu edytorów, gdzie kolorem żółtym oznaczono pole z wyborem typu opisu. Jako, że nowy opis Allegro może zawierać tylko kilka znaczników formatujących treść, edytor blokowy jest znacznie uproszczony w stosunku do pełnego edytora HTML.

.

W momencie przełączania Sello wykonuje konwersję opisu. Powoduje ona usunięcie z opisu wszelkich niedopuszczalnych w nowym opisie znaczników HTML oraz ich atrybutów (jak np. styl, czy klasa). Usunięciu podlegają również zdjęcia znajdujące się w opisie HTML. W nowym opisie nie ma możliwości linkowania zdjęć z serwerów zewnętrznych (FTP), wszystkie zdjęcia, które mają być umieszczone w opisie aukcji muszą być wysłane do Allegro. Tym samym, aby w nowym edytorze dodać zdjęcie towaru, należy w pierwszej kolejności dodać zdjęcia na zakładce ZDJĘCIA w aukcji.

Nowy opis podzielony jest na sekcje. Aktualnie Allegro udostępnia 5 rodzajów sekcji:
– Tekst
– Tekst + zdjęcie
– Zdjęcie + tekst
– Zdjęcie + zdjęcie
– Zdjęcie

W edytorze Sello aby dodać kolejną sekcję należy posłużyć się przyciskiem + DODAJ SEKCJĘ znajdującym się zawsze na dole edytowanego opisu lub z zasobnika po prawej stronie konkretnej sekcji wybrać opcję wstaw sekcję powyżej/poniżej. Domyślnie Sello wstawia sekcję typu tekst.

Z listy narzędzi w górnej części edytora, po zaznaczeniu sekcji można zmieniać jej typ, przełączając przyciski symbolizujące sekcję danego typu.

Konwersja opisu z HTML przenosi cały możliwy tekst, uwzględniając dopuszczalne tagi HTML do jednej sekcji typu tekst. Możliwa jest również konwersja w drugą stronę, z nowego opisu do HTML. Z sekcji tworzone są wtedy elementy typu div a w nich paragrafy zawierające treść.

Wybór sekcji nowego opisu Allegro

Po wybraniu sekcji z obrazkiem, pojawi się symbol pustego zdjęcia. Po kliknięciu w to zdjęcie Sello wyświetli wszystkie zdjęcia dostępne obecnie w galerii aukcji (zakładka ZDJĘCIA). Po wybraniu miniaturki zdjęcia jest ono wstawiane do opisu.
Możliwa jest zmiana typu sekcji po wpisaniu treści i wybraniu zdjęć, jednak należy wziąć pod uwagę, że zamiana sekcji zawierającej treść na sekcję bez treści (zdjęcie lub dwa zdjęcia) spowoduje usunięcie tekstu z opisu.

Nowy opis Allegro w Sello

Powyżej widok nowego opisu z sekcją typu tekst + zdjęcie.

W opisie można stosować obecnie dwa rodzaje nagłówków (odpowiednik h1 oraz h2 w HTML), pogrubianie (znacznik b), paragrafy (p), listę wypunktowaną (ul) oraz numerowaną (ol). Wszystkie te opcje są dostępne w narzędziach edytora blokowego.

NOWY EDYTOR A STARSZE SYSTEMY WINDOWS

Nowy edytor osadzony w Sello wymaga do prawidłowej pracy zainstalowanej przeglądarki Internet Explorer 11. Jeśli w systemie nie ma takiej przeglądarki zainstalowanej lub w parametrach użytkownika jest wybrany tryb zgodności HTML z wersją wcześniejszą niż 11, Sello zamiast nowego edytora uruchomi edytor uproszczony. Zaznaczamy jednak, że nowe opisy wykorzystują składnię języka HTML 5 oraz style CSS3, które nie są wspierane na starszych przeglądarkach i ich wizualna postać w edytorze uproszczonym może nieco odbiegać od wyglądu tej samej treści w Allegro.

EDYTOR UPROSZCZONY

Jest to bardzo prosta wersja edytora tekstowego prezentująca kod opisu oraz podgląd opisu w przeglądarce. W edytorze uproszczonym nie ma możliwości edycji graficznej opisu – czyli tak jak było do tej pory. Podgląd z prawej strony nie jest edycyjny. Po zmianie kodu po lewej stronie, Sello odczekuje sekundę po czym aktualizuje wygląd po stronie prawej.

Edytor uproszczony Markdown do tworzenia nowych opisów Allegro

W przypadku pracy w trybie IE11 jest możliwość przełączenia nowego edytora na edytor uproszczony – wystarczy zaznaczyć pole Edytor uproszczony. Na starszych przeglądarkach znacznik ten jest nieaktywny i domyślnie włączony. W przypadku nowych opisów daje to dodatkowe możliwości, o których poniżej.

EDYTOR UPROSZCZONY, NOWY OPIS I JĘZYK MARKDOWN

Edytując opisy HTML w edytorze uproszczonym Sello wyświetla kod HTML, który jest dość znany wśród osób zajmujących się edycją stron internetowych. W przypadku nowego opisu edytor uproszczony nie wyświetla go w swojej postaci, gdyż Allegro wymaga ściśle określonej struktury tego kodu, osadzonej w formacie JSON (HTML dopuszcza dowolną strukturę). Dla osób niezwiązanych z programowaniem zapis taki jest dosyć nieczytelny.
Dlatego też postanowiliśmy dodać uproszczony i dostosowany do wymogów Allegro zapis w formacie Markdown.

Markdown jest prostym językiem znaczników przeznaczonym do edycji treści w postaci tekstowej, przy czym umożliwia on łatwe formatowanie tego tekstu.

Edytor tekstowy Markdown do nowych opisów Allegro

Podobnie, jak w przypadku uproszczonego edytora HTML i tutaj, sekundę po edycji, Sello przetwarza kod Markdown na kod JSON według specyfikacji Allegro a następnie wyświetla jego podgląd w HTML po prawej stronie.
Dokładny opis języka Markdown stosowanego w Sello oraz dlaczego warto z niego korzystać mając nowy edytor graficzny opisujemy w dalszej części. Ogólne zasady posługiwania się tym językiem można znaleźć w sieci.

POBIERANIE AUKCJI Z SERWISU ALLEGRO

Sello rozpoznaje typ opisu po tym, jak jest on zapisany w bazie danych. Jeśli zatem obecnie część Waszych aukcji jest już wystawiona z nowym opisem i opis ten był pobierany do Sello za pomocą wersji publicznej 1.24 to Sello nie rozpozna go prawidłowo. Ale spokojnie Uśmiech.

Allegro zwraca opis w dwóch postaciach. W postaci czytelnej HTML oraz w postaci źródłowej w formacie JSON. Wersja 1.25 przy pobieraniu aukcji sprawdza czy jest opis w nowym formacie i ten właśnie opis jest zapisywany w bazie danych jako nadrzędny. Oznacza to dwie rzeczy:

  • W bazie danych Sello może istnieć tylko jedna postać opisu danej aukcji: HTML albo JSON
  • Aby Sello poprawnie rozpoznało nowy opis JSON należy dla wybranych aukcji pobrać opisy (pełne dane) jeszcze raz

Powielając tak pobraną aukcję Sello będzie już rozpoznawać opis i uruchamiać właściwą wersję edytora.

SZABLONY

Szablony opisów jak i opisy w szablonach aukcji z nowym formatem JSON działają identycznie jak szablony HTML. W edytorach tychże szablonów są dodane te same możliwości, które opisane zostały powyżej dla aukcji.

Można zatem utworzyć szablon opisu w nowym formacie, ułożyć sekcje według własnego pomysłu a następnie w szablonach aukcji podmienić zmianami zbiorczymi (ctrl+B) szablon graficzny.

ZDJĘCIA W SZABLONACH

W związku z faktem, że nowe opisy nie dopuszczają zdjęć linkowanych z zewnętrznych serwerów w szablonie opisu nie można użyć tagów [Towar::Zdjecie::X]. Tutaj nastąpiła istotna zmiana i należy zapamiętać, że w nowym opisie mogą być umieszczane tylko zdjęcia znajdujące się w galerii aukcji. W przypadku Sello oznacza to zdjęcia/tagi znajdujące się na zakładce ZDJĘCIA.

Aby zatem szablon zadziałał prawidłowo, spośród 16 dostępnych w galerii zdjęć należy zadbać o to, aby zdjęcia używane w opisie miały swoje pokrycie na zakładce ZDJĘCIA.

Wstawianie tagów zdjęć do szablonu aukcji

Proszę tutaj zwrócić uwagę, że w opisie dodajemy zdjęcia z aukcji, nie z towaru. Zdjęcia z towaru mogą być dodane do zakładki ZDJĘCIA. W przypadku szablonu aukcji, gdzie nie mamy zdjęć, pojawiają się ikony symbolizujące numer konkretnego zdjęcia z aukcji. Dlatego też nie stosujemy tutaj notacji znanej z tagów, aby odróżnić numer zdjęcia aukcji od zdjęć towarów.

Umieszczanie zdjęć w szablonie nowego opisu Allegro

Powyżej przykładowy szablon zawierający trzy sekcje wyróżnione kolorem żółtym. Zdjęcia mają widoczne numery odpowiadające kolejnym zdjęciom z galerii zdjęć.

Ikona z symbolem zdjęcia bez numeru oznacza, że w danym miejscu nie został jeszcze określony numer zdjęcia, które ma się pojawić w tym miejscu szablonu. Szablon taki jest również poprawny i można za jego pomocą wygenerować aukcje, a zdjęcie dodać na poziomie edycji aukcji przygotowanej nie modyfikując już struktury opisu. Próba wysłania aukcji zawierającej takie nieokreślone zdjęcia zakończy się niepowodzeniem – Allegro zwróci błąd informujący o niepoprawnym URL-u zdjęcia.

Jeśli w szablonie zostaną użyte zdjęcia o numerach większych niż liczba zdjęć pobrana z towaru przy generowaniu aukcji, nadmiarowe pola zostaną usunięte a sekcje skonwertowane na tekst lub zostanie taka sekcja usunięta. Dzięki temu można w szablonie umieścić odwołanie np. do 10 zdjęć a wystawiać towary zawierające 3 zdjęcia. Sekcje zawierające odwołanie do pozostałych 7 zdjęć zostaną usunięte lub skonwertowane na tekst.

POLA WŁASNE, TAGI I NOWY OPIS

Zapewne wielu z Was ma  tej chwili w opisie towarów lub w polach własnych umieszczone teksty sformatowane, czy to w postaci wizualnej czy w postaci kodu HTML. Najkorzystniej będzie sukcesywnie pozbyć się wszelkiego kodu HTML (poza wyjątkami dopuszczonymi przez Allegro).
Sello w momencie przetwarzania takich tagów do opisu w formacie JSON wykonuje czyszczenie ich treści z niedozwolonych tagów HTML oraz atrybutów. W zależności od stopnia skomplikowania tego kodu HTML może się okazać, że wyczyszczona treść nadal nie spełnia kryteriów Allegro i przy próbie wystawiania aukcji, serwis zwróci błąd o treści wskazującej na niepoprawny kod HTML. W stosunku do wersji BETA poczyniliśmy tutaj dodatkowe poprawki, aby generowany kod był przez Allegro akceptowany. Jest on dodatkowo na koniec filtrowany i poddawany przekształceniu w celu wyeliminowania nieprawidłowych zagnieżdżeń tagów HTML.

Jeśli mimo wszystko Allegro zwraca błąd związany z nieprawidłowym podzbiorem HTML można edytować taką aukcję/opis towaru/pole własne i poprawić kod. Może się okazać, że samo otworzenie edytora i zapisanie aukcji ponownie przefiltruje kod i będzie on już miał poprawną strukturę. W takich sytuacjach prosimy zgłosić do nas problem, zostanie on poprawiony lub podamy rozwiązanie.

WYSTAWIANIE AUKCJI Z NOWYM OPISEM

Wystawiając aukcję z nowym opisem, może dojść do sytuacji, że Allegro zwróci błąd informujący o niepoprawnym opisie. Dzieje się tak dlatego, że opis może być generowany z różnych fragmentów dosyć skomplikowanej struktury HTML, np. z opisu towaru.

Allegro najczęściej zwraca dwa rodzaje błędów, niekoniecznie zrozumiałych:

niepoprawny podzbiór HTML w section[0].item[1] – ten błąd należy czytać w taki sposób, że w sekcji pierwszej (section[0] oznacza sekcję pierwszą, section[1] drugą itd..) element drugi (item[1] – tutaj też liczymy począwszy od 0) zawiera niepoprawny HTML. Ta wiedza umożliwia stwierdzenie w której konkretnie sekcji jest problem i go usunąć. Przy usuwaniu błędów dobrze jest posłużyć się edytorem uproszczonym.

niepoprawny URL zdjęcia – błąd wskazuje na to, że w opisie znajduje się zdjęcie nieokreślone, czyli szara ikonka symbolizująca brak zdjęcia. Podmiana na zdjęcie prawdziwe lub usunięcie usunie ten problem.

MARKDOWN

Jak napisano wyżej, Markdown jest prostym językiem umożliwiającym tekstowe tworzenie sformatowanych treści. Poniżej opis używanych przez Sello znaczników. Wszystkie znaczniki muszą znajdować się w pierwszej kolumnie tekstu.

– 3 minusy oznaczają początek nowej sekcji. Znacznik ten występuje samotnie w linii.
# nagłówek duży – pojedynczy znak # oznacza, że w danej linii znajduje się duży nagłówek (h1). Treść występujący po znaku jest odsunięta spacją.
## nagłówek mały – podobnie jak wyżej, ale tworzony jest nagłówek mniejszy (h2).
– element listy wypunktowanej (ul). Zamiennie mogą być stosowane również * oraz +. Kolejne elementy listy należy umieszczać w nowych liniach. Po znaczniku musi być spacja.
1. – element listy numerowanej (ol). Można wstawić dowolną liczbę wraz z kropką oraz spacją. Wygenerowana lista będzie się zaczynać zawsze od 1.
**treść** – wstawienie treści pomiędzy podwójne gwiazdki oznacza pogrubienie tej treści.
ZDJECIE: 1 – oznacza utworzenie elementu ze zdjęciem, w tym wypadku pierwszym z galerii aukcji. Zwracamy uwagę na zapis ZDJECIE, bez polskiego znaku Ę.

Nowy opis Allegro w edytorze uproszczonym musi zaczynać się znacznikiem nowej sekcji . Brak takiego znacznika spowoduje, że Sello uzna ten opis za opis HTML.

Sekcja może zawierać 1 lub 2 elementy: tekst lub zdjęcie. Znacznik ZDJECIE: X powoduje dodanie w sekcji nowego elementu typu zdjęcie, zamykając tym samym wcześniej otwarty np. element tekstowy.

Oznacza to, że poniższy zapis usunie ostatnią linijkę tekstu, gdyż utworzona zostanie sekcja typu tekst + zdjęcie i na kolejny tekst pod spodem nie ma już miejsca:

---
 # Tutaj jest jakiś nagłówek

Tutaj jest jakiś akapit

Tutaj jest jakiś inny akapit z **pogrubionym fragmentem**.
ZDJECIE: 1
Tego tekstu nie będzie w opisie, ponieważ w tej sekcji są już dwa elementy, tekst i zdjęcie.

Z kolei zapis poniższy jest już poprawny i powoduje utworzenie sekcji typu zdjęcie + tekst:

---
ZDJECIE: 1
Ten tekst będzie widoczny, Sello utworzy sekcję typu zdjęcie + tekst

Sekcja typu zdjęcie + zdjęcie. Może zawierać pustą linię pomiędzy zdjęciami:

---
ZDJECIE: 1
ZDJECIE: 2
---

Ale dodanie nowej linii przed zdjęciem oznacza już pusty akapit. Dodanie pustej linii po zdjęciach również oznacza pusty akapit, ale zostanie on naturalnie odrzucony, bo już istnieją dwa elementy typu zdjęcie w sekcji.

Zatem aby utworzyć nowy akapit należy oddzielić teksty pustą linią.

Lista wypunktowana w sekcji typu zdjęcie + tekst:

---
ZDJECIE: 4
## Cechy produktu:

- odporny na ogień
- odporny na wodę
- nie zawiera ołowiu
- produkt z Polski

---

Dlaczego edytor uproszczony jest przydatny, gdy jest edytor wizualny?

Za jego pomocą można szybko podzielić jedną sekcję na kilka mniejszych – np. przy konwertowaniu opisu z HTML do opisu blokowego, aby pododawać zdjęcia, czy zmienić formatowanie, wyróżnić fragmenty tekstu. To wszystko można osiągnąć bez odrywania ręki od klawiatury, bez użycia myszki i konieczności klikania w przyciski edytora. Edytor tekstowy daje też możliwość skopiowania treści w języku Markdown i zapisanie ich poza Sello, czy przeniesienia opisu z jednej aukcji do drugiej.

Pełna lista zmian