Aktualizacja z wersji 6 do 7

LimeSurvey 7 – nowa wersja główna

Ta strona zawiera przegląd najważniejszych zmian wprowadzonych w LimeSurvey 7 oraz odnośniki do odpowiednich stron dokumentacji.

  Te informacje dotyczą głównie wersji LimeSurvey Community Edition (CE).

Najważniejsze zmiany w LimeSurvey 7

Zmieniona struktura tabel odpowiedzi i nazw pól

LimeSurvey 7 wprowadza uporządkowanie sposobu generowania tabel odpowiedzi i nazw pól. Ta zmiana poprawia spójność oraz ułatwia utrzymanie i rozbudowę platformy.

Więcej szczegółów znajdziesz tutaj: Refaktoryzacja nazw pól i tabel odpowiedzi – LimeSurvey 7

Nowy edytor pytań

LimeSurvey 7 wprowadza również nowy edytor pytań z odświeżonym interfejsem użytkownika oraz ulepszonym procesem tworzenia i zarządzania pytaniami.

Więcej szczegółów znajdziesz tutaj: Nowy edytor pytań w LimeSurvey 7

Zmiany w API RemoteControl

Odpowiedzi API RemoteControl 2 zostały ulepszone: oprócz tekstu błędu zwracają teraz również kody błędów. Zapoznaj się z dokumentacją RemoteControl 2 API, aby poznać te zmiany. W zależności od sposobu obsługi zwracanych wartości zmiana powinna być wstecznie kompatybilna, jednak może nie być prawidłowo obsługiwana w Twojej implementacji.

Więcej szczegółów znajdziesz tutaj: RemoteControl 2 API

Zmiany dotyczące stref czasowych

W wersji 6 i wcześniejszych zapisywane znaczniki czasu nie miały określonej strefy czasowej i zależały od daty/czasu serwera. Podczas migracji do wersji 7 dotychczasowe ustawienie „Różnica czasu” jest w miarę możliwości migrowane, a wszystkie nowe znaczniki czasu są zapisywane jako znaczniki UTC. Stare znaczniki czasu nie są migrowane. W ustawieniach globalnych można ustawić domyślną strefę czasową, a dla każdego użytkownika można ustawić indywidualną. Mają one wpływ wyłącznie na wyświetlanie danych. Eksport i API RemoteControl akceptują/dostarczają wyłącznie surowe znaczniki czasu.

Niestandardowe motywy ankiet

Wszystkie motywy ankiet zgodne z LS6 pozostaną aktywne po aktualizacji. Jeśli motyw ankiety był niezgodny z LS6, zostanie odinstalowany, a opcje motywu w ustawieniach globalnych, ustawieniach grupy i ustawieniach ankiety zostaną zresetowane do nowych wartości domyślnych.

Strategia aktualizacji:

1. Wyeksportuj motyw ankiety ze starej aplikacji.
2. Przed zaimportowaniem go do nowej aplikacji upewnij się, że znacznik zgodności jest ustawiony poprawnie: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. Zaimportuj go do nowej aplikacji.
4. Sprawdź kod, który dostosowałeś w motywie ankiety, i zaktualizuj go zgodnie z nową wersją aplikacji, z której chcesz korzystać.
5. Wyeksportuj zaktualizowany, dostosowany motyw ankiety z nowej aplikacji.
6. Po aktualizacji motywy ankiet zgodne z LS6 pozostaną aktywne, a starsze motywy zostaną odinstalowane.
7. Jeśli zdecydujesz się zaktualizować motyw ankiety, możesz go teraz zaimportować. Gdy potwierdzisz, że został zaktualizowany poprawnie, możesz usunąć stary motyw.

Niestandardowe motywy administratora

Domyślny motyw administratora zostanie włączony automatycznie. Motywy niestandardowe pozostaną nietknięte, ale nie będzie można ich ponownie aktywować, dopóki nie zostaną zaktualizowane.

w przypadku aplikacji hostowanej samodzielnie:

1. Przed skopiowaniem motywu administratora do nowej aplikacji upewnij się, że znacznik zgodności jest ustawiony poprawnie: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
2. Skopiuj istniejący motyw administratora ze starej aplikacji do nowej aplikacji https://manual.limesurvey.org/Custom_Admin_Themes
3. Sprawdź kod, który dostosowałeś w motywie administratora, i zaktualizuj go zgodnie z nową wersją aplikacji, z której chcesz korzystać.
4. Po aktualizacji starej aplikacji domyślnie wyświetlany jest nasz nowy motyw administratora. Aby zaktualizować wcześniej zainstalowany motyw administratora, wykonaj jedną z poniższych czynności:
   • Ręcznie zaktualizuj kod motywu administratora oznaczonego obecnie jako niezgodny.
   • Usuń stary motyw administratora i zainstaluj nowy, który wcześniej zaktualizowałeś w środowisku testowym.

dla użytkowników Cloud:
Skontaktuj się z naszym wsparciem.

Niestandardowe motywy pytań

Niestandardowe motywy pytań, które nie są zgodne z bieżącą wersją, nie mogą zostać zainstalowane, ale po aktualizacji nadal będą aktywne. Więcej informacji o motywach pytań znajdziesz tutaj: Motywy pytań. Niestandardowy kod JavaScript wstawiony do motywu ankiety lub do dowolnego pytania w ankiecie prawdopodobnie również przestanie działać.

Aktualizacja niestandardowego motywu pytań:

1. Pobierz motyw pytań ze strony internetowej lub wyeksportuj bieżący motyw pytań.
2. Przed przesłaniem upewnij się, że zgodność Twojego niestandardowego motywu pytań jest ustawiona poprawnie.
3. Spróbuj przesłać motyw pytań do nowej aplikacji.
4. Jeśli jest to motyw pytań stworzony samodzielnie, wprowadź niezbędne poprawki.
5. Po pomyślnym przesłaniu sprawdź, czy motyw pytań jest wyświetlany i działa zgodnie z oczekiwaniami.

Aktualizacja motywu, którego nie jesteś właścicielem:
Sprawdź, czy strona internetowa lub autor, od którego go otrzymałeś, udostępnia aktualizację.

Niestandardowe wtyczki

Niestandardowe wtyczki, które nie są zgodne z bieżącą wersją, zostaną dezaktywowane podczas procesu aktualizacji.

w przypadku aplikacji hostowanej samodzielnie:

1. Sprawdź, czy wtyczkę można zainstalować w nowej wersji.
2. Zaktualizuj wtyczkę lub skontaktuj się z jej autorem, aby udostępnił aktualizację.
3. Ręcznie nadpisz wtyczkę nowymi plikami w swojej aplikacji, co zachowa ustawienia, albo odinstaluj starą wersję i zainstaluj nową – w takim przypadku wszystkie ustawienia trzeba będzie wprowadzić ponownie.

dla użytkowników Cloud:

1. LimeSAML pozostanie aktywny.
2. Sprawdź, czy wtyczkę można zainstalować w nowej wersji.
3. Zaktualizuj kod wtyczki lub skontaktuj się z jej autorem, aby udostępnił aktualizację.
4. Opcje instalacji:
   • Odinstaluj starą wersję i zainstaluj nową (wszystkie ustawienia zostaną utracone i trzeba będzie je zastosować ponownie).
   • Skontaktuj się z wsparciem, aby zaktualizować wtyczkę bez utraty danych konfiguracji.

Wymagania

	LimeSurvey 6	LimeSurvey 7
PHP	7.4 lub nowszy	8.1 lub nowszy (zalecany 8.3)
MySQL	8.0 lub nowszy	8.0 lub nowszy
MariaDB	10.3.38 lub nowszy	10.3.38 lub nowszy
PostgreSQL	12 lub nowszy	14 lub nowszy
MSSQL	2016 lub nowszy	2019 lub nowszy
Format URL	get lub path	path, wymagany dla nowego edytora

Nie potrzebujesz Node.js ani npm. Nowy edytor jest dołączony do pakietu LimeSurvey i jest gotowy do użycia.

Przed rozpoczęciem wykonaj pełną kopię zapasową plików i bazy danych, a upgrade najpierw przetestuj na kopii swojej instalacji. Po przeprowadzeniu upgrade'u jedynym sposobem powrotu jest przywrócenie tej kopii zapasowej.

Zaplanuj okno serwisowe. LimeSurvey przełącza witrynę w Tryb konserwacji na czas upgrade'u bazy danych, a w instalacjach z dużą ilością danych odpowiedzi może to chwilę potrwać.

Zalecane: skorzystaj z usługi ComfortUpdate

Najprostszym i najbezpieczniejszym sposobem aktualizacji jest skorzystanie z usługi ComfortUpdate. Pobiera ona i instaluje nową wersję za Ciebie, więc nie musisz ręcznie podmieniać żadnych plików.

Jeśli wolisz przeprowadzić aktualizację ręcznie, postępuj zamiast tego według poniższych kroków.

Aktualizacja ręczna

1. Wykonaj kopię zapasową plików i bazy danych, a następnie przełącz witrynę w Tryb konserwacji.
2. Zachowaj następujące pliki i foldery ze starej instalacji:
   • application/config/config.php
   • application/config/security.php
   • application/config/allowed_hosts.php
   • folder upload/, w którym znajdują się przesłane pliki, motywy użytkownika i wtyczki użytkownika
   • folder plugins/, jeśli wtyczki zostały do niego zainstalowane ręcznie
3. Pobierz pakiet LimeSurvey 7 i zaktualizuj instalację jedną z poniższych metod:
   1. Najpierw usuń stare pliki. Przesuń wymienione wyżej pliki w bezpieczne miejsce, usuń całą pozostałą zawartość katalogu LimeSurvey, rozpakuj do niego nowy pakiet i przywróć zachowane pliki.
   2. Lub skopiuj nowe pliki na stare. Rozpakuj nowy pakiet na istniejącą instalację i pozwól, aby nadpisał to, co już się tam znajduje, pozostawiając wymienione wyżej pliki nietknięte.
4. W obu przypadkach użyj nowego pliku .htaccess z pakietu, ponieważ wersja z 6.x nie działa z nowym edytorem. Następnie opróżnij tmp/runtime/, aby nie pozostały w nim żadne dane z pamięci podręcznej z wersji 6.
5. Ustaw format URL na path w pliku application/config/config.php.
6. Upewnij się, że Twój serwer WWW udostępnia folder /editor/ bezpośrednio i przekazuje nagłówek Authorization do PHP. Więcej szczegółów: Nowy edytor pytań w LimeSurvey 7
7. Uruchom Upgrade bazy danych. LimeSurvey wykrywa starszą wersję bazy danych i proponuje jej aktualizację. Potwierdź i poczekaj na zakończenie, nie przerywając procesu.
8. Po zakończeniu wyłącz Tryb konserwacji i wykonaj kroki z poniższej listy kontrolnej.

Po aktualizacji

• Sprawdź numer wersji w stopce stron administracyjnych.

• Aktywuj ponownie potrzebne wtyczki, jedna po drugiej.

• Otwórz ankietę i potwierdź, że nowy edytor się ładuje.

• Przeprowadź jedną pełną testową odpowiedź w każdej aktywnej ankiecie, sprawdzając warunki, limity, e-maile i Końcowy URL.

Rozwiązywanie problemów

Komunikat „Konieczne działanie” dotyczący formatu URL. Format URL nadal ma wartość get. Zmień go na path i wyczyść tmp/runtime/.

Edytor się ładuje, ale pozostaje pusty. Nagłówek Authorization nie dociera do PHP.

/editor/ wyświetla stronę LimeSurvey lub błąd „Nie znaleziono”. Sprawdź konfigurację serwera WWW i upewnij się, że folder /editor/ jest udostępniany bezpośrednio, a nie przekierowywany przez LimeSurvey.

„Nie możesz używać tego motywu z nowym edytorem pytań”. Ankieta używa motywu, który nie jest oparty na fruity_twentythree. Zmień motyw lub kontynuuj w klasycznym edytorze.

Wtyczka powoduje błędy po ponownej aktywacji. Nie jest zgodna z LimeSurvey 7. Dezaktywuj ją i skontaktuj się z jej autorem.

Uwagi

Każda duża zmiana jest opisana na osobnej stronie. Dzięki temu dokumentacja pozostaje przejrzysta, a informacje istotne dla Twojej konfiguracji łatwiej znaleźć.