13 marca 2018 wygasa domena Allegro, która do tej pory służyła do łączenia się z API Allegro oraz do autoryzacji aplikacji. W związku z tym publikujemy aktualizację Sello, a sama poprawka jest traktowana jako krytyczna, aby móc obsługiwać serwis Allegro od 13 marca. Prosimy o jak najszybszą aktualizację oprogramowania.
10 marca 2018 planujemy przeniesienie obecnego forum Sello na nową platformę. Poniżej przedstawiamy nieco informacji na ten temat. Prosimy o zapoznanie się z ich treścią, gdyż pomogą zmigrować konta użytkowników.
1. Forum Sello przeniesione zostanie na platformę Forum Użytkowników InsERT, znajdującą się pod adresem forum.insert.com.pl, gdzie Sello będzie miało swój osobny, wydzielony dział.
2. Przeniesieniu ulegnie całe forum Sello, wszystkie wątki, załączniki oraz konta użytkowników.
3. Na nowym forum każdy użytkownik, który nie posiada jeszcze Konta InsERT, będzie musiał je założyć. Umożliwia ono pisanie na forum użytkowników InsERT, jak również zarządzanie własnymi licencjami na programy InsERT.
Przeniesione konta użytkowników ze starego forum Sello będą podłączone do kont InsERT, pod warunkiem, że podczas zakładania Konta InsERT zostanie użyty ten sam adres e-mail, który był użyty do założenia konta na forum Sello.
Użytkownicy posiadający już Konto InsERT, ale założone na inny adres e-mail, mogą przed wykonaniem migracji zmienić adres użytkownika na forum Sello na właściwy/obecnie używany. Również osoby, które nie chcą już korzystać ze starego adresu e-mail użytego na starym forum Sello mogą ten adres zmienić przed migracją na nowe forum edytując swój profil.
4. Konto InsERT można zakładać już teraz, przed migracją forum Sello.
5. Wszelkie linki odwołujące się do starego forum Sello zostaną skonwertowane na nowe, dostosowane do nowej platformy (IPB), zostaną też utworzone przekierowania adresów ze starego forum na nowe.
6. Na nowym forum przeprowadzimy drobne zmiany organizujące działy forum w inny, bardziej czytelny sposób.
7. Daty utworzenia kont zostaną zaktualizowane w późniejszym terminie, tak aby odpowiadały danym ze starego forum.
8. Migrację planujemy rozpocząć 10 marca 2018 roku (sobota). Będzie się to wiązało z wyłączeniem dostępu do starego forum. Jest to proces długotrwały więc uruchomienie nowego forum planujemy na poniedziałek 12 marca.
9. Po migracji stare forum zostanie wyłączone i nie będzie już dostępne.
W razie pytań lub wątpliwości, zapraszamy na nasze – jeszcze stare, forum do tego wątku.
Poprawione zostało działanie tagów h1, h2, które w specyficznych warunkach generowane były jako nowy paragraf zamiast jako nagłówek. Prócz tego zmieniliśmy działanie funkcji Dodaj aukcję oraz Powiel aukcję tak, aby nie usuwały one automatycznie pustych zdjęć – dzięki temu istnieje możliwość wczytania do tworzonej aukcji nowych zdjęć bez utraty ich w opisie.
NOWOŚCI
W oknie zdjęć dodaliśmy kilka usprawnień. Jest to przede wszystkim możliwość zaznaczania wielu zdjęć (klawisz Ctrl+klik) oraz zaznaczania wszystkich zdjęć (Ctrl+A) w celu szybszego ich usuwania. Dodatkowo w usuwaniu może pomóc drobna zmiana, która po usunięciu zdjęcia pozostawia zaznaczone kolejne zdjęcie – dzięki temu można usuwać kolejne zdjęcia wciskając po prostu klawisz Delete.
Dodaliśmy również przed nazwą zdjęcia jego aktualną pozycję oraz nieco zmieniliśmy sposób wyświetlania miniaturek i ich zaznaczenie.
Allegro opublikowało informację dotycząca zakończenia obsługi szyfrowania TLS 1.0. Oznacza to, że Sello uruchomione na starszych systemach nie będzie w stanie połączyć się z API Allegro. Użytkownicy systemu Windows XP oraz Windows Server 2003 stracą możliwości korzystania z API Allegro.
Użytkownicy systemów poniżej Windows 8.1 muszą włączyć obsługę TLS 1.1 oraz/lub TLS 1.2 w Opcjach Internetowych > zakładka Zaawansowane, jeśli jeszcze obsługa tych protokołów nie została włączona. Użytkownikom starszych wersji zalecamy aktualizację systemu Windows do nowych wersji*.
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.
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.
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ść.
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.
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.
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.
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 .
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.
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.
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.
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.
Przypominamy, że jest to wersja BETA. Dołożyliśmy wszelkich starań aby wersja BETA była stabilna i działająca poprawnie ale mimo wszystko mogą w niej wystąpić nieoczekiwane problemy utrudniające pracę. Prosimy o świadome instalowanie wersji BETA.
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.
W tym wątku prosimy zgłaszać błędy i sugestie odnośnie wersji BETA.
ZNANE PROBLEMY W WERSJI BETA
– brak informacji o nowościach w 1.25
– problem z wklejaniem tagów do edytora po dwukliku (przed kliknięciem na tag w drzewku kursor musi być widoczny w oknie edytora)
– nie działa edytor opisu dla serwisu eBay. Użytkowników eBaya prosimy o powstrzymanie się od instalacji wersji BETA.
– problem z pierwszym zdjęciem w nowym edytorze – należy nacisnąć dwa razy na zdjęcie aby przejść do okna wyboru zdjęcia
– problem z przeskakiwaniem zdjęć w nowym edytorze po dodaniu nowego zdjęcia – należy najpierw dodać zdjęcia, potem przejść do edycji opisu
– problem ze znikającym kursorem w oknie edytora uproszczonego – należy kliknąć na dowolny inny element okna i powrócić do edytora, kursor pojawi się ponownie
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ść.
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.
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.
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.
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 .
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.
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.
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.
W związku ze zmianą wymagań odnośnie nowych ofert wystawianych w serwisie Allegro przygotowujemy wersję Sello, która będzie umożliwiała wystawianie aukcji z nowymi opisami.
Według harmonogramu ogłoszonego przez serwis Allegro nowe opisy będą obowiązywały od lutego 2018.
Na początku stycznia planujemy wypuścić Sello 1.25, które będzie dostosowane do nowych wymagań Allegro w zakresie wystawiania aukcji. Obecnie kończymy prace nad zmianami w programie, jednak ze względu na okres świąteczny będziemy w stanie wypuścić program po nowym roku.
Dalsze modyfikacje, w tym możliwość zmiany opisów w aukcjach trwających, pojawią się w kolejnych wersjach, które będziemy systematycznie dostarczać po zrealizowaniu nowych funkcji w programie.
Zgodnie z harmonogramem, stare opisy typu HTML mają być zastąpione nowymi do czerwca 2018.
Wersja 1.24.2 usuwa problem wyłączania się programu przy pobieraniu danych aukcji. Dodatkowo dodaliśmy również obsługę nowych dostaw Allegro oraz poprawkę wysyłania wiadomości e-mail.
Wersja 1.24.2 nie przeprowadza aktualizacji bazy z wersji 1.24.0.
LISTA ZMIAN
Allegro
– Dodano obsługę nowych dostaw Allegro: Kurier wieczór oraz Kurier wieczór pobranie
– Poprawiono problem zamykania się aplikacji przy pobieraniu aukcji z kategorią usuniętą w serwisie Allegro
Wiadomości
– Poprawiono domenę w nagłówku wiadomości e-mail Message-Id – problem z trafianiem wiadomości Sello do spamu
Przypominamy, że obecnie aby wystawić aukcję w serwisie Allegro konieczne jest uzupełnienie pól z warunkami zwrotów oraz reklamacji. Pola te znajdują się w oknie aukcji na zakładce PODSTAWOWE.
Aby cały proces przeszedł sprawnie, trzeba wykonać kilka koniecznych czynności:
1. W panelu Allegro uzupełnić informacje o warunkach zwrotów oraz reklamacji dla każdego posiadanego konta oddzielnie.
2. Zainstalować Sello w wersji co najmniej 1.24.1, nową wersję można pobrać stąd.
3. Po instalacji należy autoryzować każde konto w Sello osobno do wykonywania dodatkowych operacji w Allegro. Autoryzacja związana jest z dostępem do nowego serwera API Allegro, który oferuje obsługę nowości w serwisie.
Autoryzację kont należy przeprowadzić w oknie zarządzania kontami i licencjami w Sello, wybierając link Autoryzuj.
Należy zwrócić przy tym uwagę, aby wpisać dane logowania do konta, które faktycznie jest w danej chwili autoryzowane. Niedopilnowanie tego faktu spowoduje, że autoryzacja się powiedzie, ale w czasie synchronizacji wystąpi problem dotyczący braku dostępu do danego konta.
4. Pobranie stworzonych w Allegro warunków do Sello. Menu Sello > Narzędzia > Synchronizuj parametry z serwisu. Jeśli przy pobieraniu wystąpi jakiś błąd, należy przyjrzeć się jego treści w oknie raportu (pełny log). W razie problemów z jego interpretacją można o taki błąd zapytać na forum lub skorzystać z wyszukiwania, co często pozwala uzyskać odpowiedź w krótszym czasie.
5. W oknie nowej aukcji należy wybrać teraz pobrane z Allegro warunki oferty. Można również skorzystać ze zmian zbiorczych Ctrl+B aby zmienić warunki jednocześnie na wielu aukcjach. Warunki można również określić w szablonie aukcji.
Wersja 1.24.1 nie przeprowadza aktualizacji bazy z wersji 1.24.0.
LISTA ZMIAN
Allegro
– Poprawiono problem pobierania słownika zwrotów, reklamacji i gwarancji dla kolejnych kont Allegro
– Poprawiono problem z wyborem czasu trwania aukcji sklepowej 30 dni
Aukcje
– Poprawiono problem z zawieszaniem się widoków HTML (pusty ekran atrybutów specyficznych, strony startowej, podglądów szczegółów) po wykonaniu zmian zbiorczych specyficznych
eBay
– Poprawiono problem z pobieraniem atrybutów specyficznych
– Poprawiono problem z wyświetlaniem atrybutu stan towaru