Nâng cấp từ phiên bản 6 lên 7
From LimeSurvey Manual
Phiên bản chính LimeSurvey 7
Trang này cung cấp tổng quan về các thay đổi chính được giới thiệu trong LimeSurvey 7 và các liên kết đến những trang tài liệu liên quan.
Thông tin này chủ yếu áp dụng cho LimeSurvey Community Edition (CE).
Các thay đổi chính trong LimeSurvey 7
Cấu trúc bảng phản hồi và tên trường đã được thay đổi
LimeSurvey 7 giới thiệu việc dọn dẹp cấu trúc cách tạo bảng phản hồi và tên trường. Thay đổi này giúp tăng tính nhất quán và giúp nền tảng dễ bảo trì và mở rộng hơn.
Xem thêm chi tiết tại đây: Tái cấu trúc tên trường và bảng phản hồi - LimeSurvey 7
Trình chỉnh sửa câu hỏi mới
LimeSurvey 7 cũng giới thiệu trình chỉnh sửa câu hỏi mới với giao diện người dùng được cập nhật và quy trình tạo và quản lý câu hỏi được cải thiện.
Xem thêm chi tiết tại đây: Trình chỉnh sửa câu hỏi mới trong LimeSurvey 7
Các thay đổi của RemoteControl API
Các phản hồi từ RemoteControl 2 API đã được cải thiện bằng cách trả về mã lỗi bên cạnh nội dung lỗi. Vui lòng xem tài liệu RemoteControl 2 API để biết các thay đổi này. Tùy cách bạn xử lý các giá trị trả về, thay đổi này nhìn chung tương thích ngược - tuy nhiên có thể chưa được xử lý đúng trong phần triển khai của bạn.
Xem thêm chi tiết tại đây: RemoteControl 2 API
Thay đổi về múi giờ
Trong phiên bản 6 và các phiên bản trước, dấu thời gian được ghi lại không xác định múi giờ và phụ thuộc vào ngày giờ của máy chủ. Khi chuyển lên phiên bản 7, thiết lập 'Time difference' cũ sẽ được chuyển đổi nếu có thể, và tất cả dấu thời gian về sau được ghi lại dưới dạng dấu thời gian UTC. Các dấu thời gian cũ không được chuyển đổi. Bạn có thể đặt múi giờ mặc định toàn cục trong thiết lập toàn cục, và có thể đặt múi giờ riêng cho từng người dùng. Các múi giờ này chỉ áp dụng cho việc hiển thị dữ liệu. Xuất dữ liệu và RemoteControl API sẽ chỉ chấp nhận/trả về các dấu thời gian gốc.
Chủ đề khảo sát tùy chỉnh
Tất cả chủ đề khảo sát tương thích với LS6 sẽ vẫn hoạt động sau khi nâng cấp. Nếu chủ đề khảo sát không tương thích với LS6, chúng sẽ bị gỡ cài đặt, và các tùy chọn chủ đề trong thiết lập toàn cục, nhóm và thiết lập khảo sát sẽ được đặt lại về mặc định mới.
Chiến lược nâng cấp:
- Xuất chủ đề khảo sát từ ứng dụng cũ
- Trước khi tải nhập vào ứng dụng mới, hãy đảm bảo thẻ tương thích được đặt đúng: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
- Tải nhập chủ đề vào ứng dụng mới
- Kiểm tra mã bạn đã tùy chỉnh cho chủ đề khảo sát và cập nhật cho phù hợp với phiên bản mới của ứng dụng mà bạn muốn sử dụng.
- Xuất chủ đề khảo sát tùy chỉnh đã cập nhật từ ứng dụng mới
- Sau khi nâng cấp, các chủ đề khảo sát tương thích với LS6 sẽ vẫn hoạt động, còn các chủ đề cũ hơn sẽ bị gỡ cài đặt.
- Nếu bạn chọn cập nhật một chủ đề khảo sát, bây giờ bạn có thể tải nhập nó. Sau khi xác nhận rằng chủ đề đã được cập nhật đúng, bạn có thể chọn xóa chủ đề cũ.
Chủ đề quản trị tùy chỉnh
Chủ đề quản trị mặc định sẽ được bật theo mặc định. Các chủ đề tùy chỉnh sẽ được giữ nguyên nhưng không thể kích hoạt lại trừ khi được cập nhật.
Đối với ứng dụng tự lưu trữ:
- Trước khi sao chép chủ đề quản trị sang ứng dụng mới, hãy đảm bảo thẻ tương thích được đặt đúng: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
- Sao chép chủ đề quản trị hiện có từ ứng dụng cũ sang ứng dụng mới https://manual.limesurvey.org/Custom_Admin_Themes
- Kiểm tra mã bạn đã tùy chỉnh cho chủ đề quản trị và cập nhật cho phù hợp với phiên bản mới của ứng dụng mà bạn muốn sử dụng.
- Sau khi nâng cấp ứng dụng cũ, chủ đề quản trị mới của chúng tôi sẽ được hiển thị theo mặc định. Để cập nhật chủ đề quản trị đã cài đặt trước đó, bạn có thể:
- Cập nhật thủ công mã của chủ đề quản trị hiện đang được đánh dấu là không tương thích
- Xóa chủ đề quản trị cũ và cài đặt chủ đề mới mà bạn đã cập nhật trước đó trong môi trường thử nghiệm.
Đối với người dùng Cloud:
Vui lòng liên hệ bộ phận hỗ trợ của chúng tôi.
Chủ đề câu hỏi tùy chỉnh
Các chủ đề câu hỏi tùy chỉnh không khớp với phiên bản hiện tại không thể được cài đặt, nhưng vẫn sẽ hoạt động sau khi nâng cấp. Bạn có thể tìm thêm thông tin về chủ đề câu hỏi tại đây Chủ đề câu hỏi. JavaScript tùy chỉnh được chèn vào chủ đề khảo sát hoặc bất kỳ câu hỏi nào trong khảo sát cũng có thể sẽ không còn hoạt động.
Nâng cấp chủ đề câu hỏi tùy chỉnh của bạn:
- Tải xuống chủ đề câu hỏi từ một trang web hoặc xuất chủ đề câu hỏi hiện tại
- Trước khi tải lên, hãy đảm bảo khả năng tương thích của chủ đề câu hỏi tùy chỉnh của bạn đã được đặt đúng
- Thử tải chủ đề câu hỏi của bạn lên ứng dụng mới.
- Nếu đó là chủ đề câu hỏi do bạn tự tạo, hãy thực hiện các điều chỉnh cần thiết
- Sau khi tải lên thành công, vui lòng kiểm tra xem chủ đề câu hỏi có được hiển thị và hoạt động như mong đợi hay không.
Nâng cấp chủ đề không phải do bạn sở hữu:
Hãy kiểm tra xem trang web hoặc nhà phát triển cung cấp chủ đề có bản cập nhật hay không
Plugin tùy chỉnh
Các plugin tùy chỉnh không khớp với phiên bản hiện tại sẽ bị vô hiệu hóa trong quá trình nâng cấp.
Đối với ứng dụng tự lưu trữ:
- Kiểm tra xem plugin có thể được cài đặt trên phiên bản mới hay không.
- Cập nhật plugin hoặc liên hệ tác giả plugin để cập nhật plugin.
- Ghi đè thủ công plugin bằng các tệp mới trong ứng dụng của bạn để giữ lại các cài đặt, hoặc gỡ cài đặt phiên bản cũ và cài đặt lại phiên bản mới; trong trường hợp đó, tất cả cài đặt sẽ phải nhập lại.
Đối với người dùng Cloud:
- LimeSAML sẽ vẫn hoạt động
- Kiểm tra xem plugin có thể được cài đặt trên phiên bản mới hay không.
- Cập nhật mã plugin hoặc liên hệ tác giả plugin để cập nhật plugin.
- Các tùy chọn cài đặt:
- Gỡ cài đặt phiên bản cũ và cài đặt lại phiên bản mới (tất cả cài đặt sẽ bị mất và phải áp dụng lại)
- Liên hệ bộ phận hỗ trợ để cập nhật plugin mà không làm mất dữ liệu cấu hình
Yêu cầu
| LimeSurvey 6 | LimeSurvey 7 | |
|---|---|---|
| PHP | 7.4 trở lên | 8.1 trở lên (khuyến nghị 8.3) |
| MySQL | 8.0 trở lên | 8.0 trở lên |
| MariaDB | 10.3.38 trở lên | 10.3.38 trở lên |
| PostgreSQL | 12 trở lên | 14 trở lên |
| MSSQL | 2016 trở lên | 2019 trở lên |
| Định dạng URL | get hoặc path |
path, bắt buộc đối với trình chỉnh sửa mới
|
Bạn không cần Node.js hoặc npm. Trình chỉnh sửa mới đã được đưa vào gói LimeSurvey và sẵn sàng để sử dụng.
Hãy sao lưu đầy đủ các tệp và cơ sở dữ liệu của bạn trước khi bắt đầu, và thử nâng cấp trên một bản sao của hệ thống cài đặt trước. Sau khi quá trình nâng cấp đã chạy, bạn không thể quay lại trừ khi khôi phục từ bản sao lưu đó.
Hãy lên kế hoạch cho một khoảng thời gian bảo trì. LimeSurvey chuyển trang web sang chế độ bảo trì trong khi cơ sở dữ liệu đang được nâng cấp, và với các hệ thống cài đặt có nhiều dữ liệu phản hồi thì quá trình này có thể mất khá nhiều thời gian.
Khuyến nghị: Sử dụng dịch vụ ComfortUpdate của chúng tôi
Cách nâng cấp dễ dàng và an toàn nhất là sử dụng dịch vụ ComfortUpdate của chúng tôi. Dịch vụ này tải xuống và cài đặt phiên bản mới cho bạn, vì vậy bạn không phải thay thế các tệp theo cách thủ công.
Nếu bạn muốn nâng cấp thủ công, hãy làm theo các bước bên dưới.
Nâng cấp thủ công
- Sao lưu các tệp và cơ sở dữ liệu của bạn, đồng thời chuyển trang web sang chế độ bảo trì.
- Giữ lại các tệp và thư mục sau từ hệ thống cài đặt cũ của bạn:
application/config/config.phpapplication/config/security.phpapplication/config/allowed_hosts.php- thư mục
upload/, nơi chứa các tệp đã tải lên, chủ đề người dùng và plugin người dùng của bạn - thư mục
plugins/, nếu bạn đã cài đặt plugin vào đó theo cách thủ công
- Tải xuống gói LimeSurvey 7 và cập nhật hệ thống cài đặt bằng một trong các phương pháp sau:
- Xóa các tệp cũ trước. Di chuyển các tệp đã liệt kê ở trên ra chỗ khác, xóa mọi thứ còn lại trong thư mục LimeSurvey của bạn, giải nén gói mới vào đó và đặt các tệp đã giữ lại về vị trí cũ.
- Hoặc sao chép các tệp mới đè lên các tệp cũ. Giải nén gói mới lên hệ thống cài đặt hiện có của bạn và để nó ghi đè lên những gì đã có, đồng thời giữ nguyên các tệp đã liệt kê ở trên.
- Với cả hai cách, hãy sử dụng tệp
.htaccessmới từ gói, vì tệp của phiên bản 6.x không hoạt động với trình chỉnh sửa mới. Sau đó, hãy làm trốngtmp/runtime/để không còn dữ liệu bộ nhớ đệm nào của phiên bản 6 sót lại. - Đặt định dạng URL thành
pathtrongapplication/config/config.php. - Đảm bảo máy chủ web của bạn phục vụ trực tiếp thư mục
/editor/và chuyển tiếp tiêu đềAuthorizationđến PHP. Chi tiết xem thêm: Trình chỉnh sửa câu hỏi mới trong LimeSurvey 7 - Chạy quá trình nâng cấp cơ sở dữ liệu. LimeSurvey phát hiện phiên bản cơ sở dữ liệu cũ hơn và đề nghị nâng cấp. Hãy xác nhận và để quá trình hoàn tất mà không bị gián đoạn.
- Khi hoàn tất, hãy tắt chế độ bảo trì và thực hiện lần lượt danh sách kiểm tra bên dưới.
Sau khi nâng cấp
- Kiểm tra số phiên bản ở chân trang của các trang quản trị.
- Kích hoạt lại các plugin bạn cần, từng cái một.
- Mở một khảo sát và xác nhận rằng trình chỉnh sửa mới được tải.
- Chạy một phản hồi thử nghiệm đầy đủ cho từng khảo sát đang hoạt động, bao gồm các điều kiện, hạn ngạch, e-mail và URL kết thúc.
Khắc phục sự cố
Thông báo "Action needed" về định dạng URL. Định dạng URL vẫn là get. Hãy đổi thành path và xóa nội dung của tmp/runtime/.
Trình chỉnh sửa được tải nhưng vẫn trống. Tiêu đề Authorization không đến được PHP.
/editor/ hiển thị một trang LimeSurvey hoặc lỗi "Không tìm thấy". Hãy kiểm tra cấu hình máy chủ web của bạn và đảm bảo thư mục /editor/ được phục vụ trực tiếp thay vì được định tuyến qua LimeSurvey.
"You cannot use this theme with the new question editor". Khảo sát sử dụng một chủ đề không dựa trên fruity_twentythree. Hãy đổi chủ đề, hoặc tiếp tục trong trình chỉnh sửa cổ điển.
Một plugin gây ra lỗi sau khi được kích hoạt lại. Plugin đó không tương thích với LimeSurvey 7. Hãy hủy kích hoạt và liên hệ với người bảo trì plugin.
Ghi chú
Mỗi thay đổi lớn đều được ghi lại trên một trang riêng. Điều này giúp tài liệu tập trung hơn và giúp bạn dễ tìm thông tin phù hợp với thiết lập của mình hơn.