Làm việc trên một trang web mà ai đó đã chia sẻ với bạn

Chủ sở hữu của một trang web có thể cấp cho bạn quyền truy cập vào một trong các trang web của họ — không phải tài khoản, không phải hóa đơn và không phải các trang web khác của họ — và bạn có thể làm việc trên trang web đó bằng thông tin đăng nhập Zinn Digital® của chính bạn cùng với công cụ dòng lệnh Zinnector® miễn phí. Hướng dẫn này bao gồm cả hai khía cạnh đó: những việc chủ sở hữu làm và những việc bạn làm.

Nếu bạn chưa từng sử dụng Zinnector® trước đây, Bắt đầu với Zinnector® sẽ cài đặt công cụ này trong khoảng hai phút. Không có phần nào trong này yêu cầu bạn phải mua dịch vụ lưu trữ.

Dành cho chủ sở hữu trang web — chia sẻ một trang web

1. Mở trang web trong bảng điều khiển của bạn và đi tới mục Bảo mật.
2. Trong phần Những ai khác có thể truy cập trang web này, hãy chọn Chia sẻ trang web này.
3. Nhập địa chỉ email của lập trình viên. Họ chưa cần phải có tài khoản — nếu họ chưa từng đăng nhập, họ sẽ nhận được lời mời và quyền truy cập sẽ có hiệu lực ngay khi họ chấp nhận.
4. Chọn một vai trò:

• Người xem — có thể xem, và không thể thay đổi bất kỳ thứ gì.
• Người chỉnh sửa — vai trò mà lập trình viên thường cần. Họ có thể thay đổi các tệp của trang web, sử dụng wp-admin và tải xuống bản lưu trữ của trang web để làm việc cục bộ. Bản lưu trữ đó bao gồm cả cơ sở dữ liệu.
• Quản lý — mọi tính năng mà người chỉnh sửa có thể làm, cộng thêm việc khôi phục bản sao lưu.

1. Cung cấp lý do và, nếu công việc có ngày kết thúc, hãy đặt thời hạn. Quyền truy cập sẽ tự động ngừng tính đến ngày đó; bạn không cần phải nhớ thủ công việc gỡ bỏ quyền này.
2. Lưu lại.

Bất kể bạn chọn gì, cộng tác viên không bao giờ có thể xóa trang web, xem hóa đơn của bạn hoặc truy cập vào bất kỳ trang web nào khác của bạn.

Ý nghĩa của cụm từ "bản lưu trữ bao gồm cơ sở dữ liệu"

Một người chỉnh sửa hoặc quản lý có thể lấy một bản sao của trang web để làm việc, và bản sao của trang web bao gồm các tệp và cơ sở dữ liệu của trang web đó. Cơ sở dữ liệu WordPress lưu trữ mọi thông tin mà khách truy cập đã cung cấp cho trang web — tên và địa chỉ email của người bình luận, tài khoản khách hàng, đơn hàng và địa chỉ giao hàng trên WooCommerce, các nội dung gửi qua biểu mẫu.

Điều đó thông thường chính xác là những gì một lập trình viên cần: nếu không có nó, họ sẽ chỉ nhìn thấy giao diện chủ đề (theme) của bạn trên một trang web trống. Điều này rất đáng lưu ý, vì đó là dữ liệu cá nhân thực tế và những người sở hữu dữ liệu đó là khách hàng của bạn, chứ không phải của chúng tôi.

Hai điều sẽ xảy ra, và nền tảng sẽ thực hiện cả hai điều đó cho bạn:

• Mọi thao tác xuất dữ liệu đều nằm trong nhật ký kiểm tra (audit log) của bạn. Hãy mở Nhật ký kiểm tra và tìm mục site.backup.exported. Mỗi hàng ghi rõ ai đã thực hiện thao tác đó, thời gian nào, và bản lưu trữ đó có mang theo cơ sở dữ liệu hay không. Bạn không cần phải hỏi lại.
• Bạn có thể chấm dứt quyền truy cập bất cứ lúc nào. Việc thu hồi diễn ra ngay lập tức — xem phần bên dưới.

Nếu bạn muốn họ làm việc mà không có cơ sở dữ liệu, hãy bảo họ thêm tham số --no-database khi họ thực hiện lệnh kéo (pull); chỉ cần một cờ (flag) này và mọi thứ còn lại sẽ hoạt động bình thường.

Dành cho lập trình viên — đưa trang web về máy của bạn

1. Cài đặt Zinnector®

npm install -g zinnector
zinnector --version

Bạn cần Node phiên bản 24 trở lên. Lệnh node --version phải hiển thị kết quả là v24 hoặc cao hơn.

2. Đăng nhập bằng tài khoản của chính bạn

zinnector login

Thao tác này sẽ mở trình duyệt của bạn và đăng nhập bằng tài khoản Zinn Digital® của chính bạn — tài khoản đã nhận được lời mời. Bạn không bao giờ cần mật khẩu của chủ sở hữu và họ cũng không bao giờ cần phải cung cấp mật khẩu cho bạn.

Kiểm tra những gì đã được cấp cho bạn:

zinnector sites

Bạn sẽ nhìn thấy chính xác các trang web được chia sẻ với bạn và không có gì khác. Nếu danh sách trống, nghĩa là lời mời vẫn chưa được chấp nhận, hoặc quyền truy cập đã bị thu hồi hoặc đã hết hạn.

3. Tải trang web về máy

zinnector clone client-domain.com
cd client-domain.com

Lệnh clone tạo một dự án cục bộ từ trang web được lưu trữ trên máy chủ. Lệnh này bao gồm:

• wp-content — các chủ đề (themes), trình cắm (plugins), trình cắm bắt buộc (mu-plugins), ngôn ngữ và tệp phương tiện thuộc về trang web đó;
• cơ sở dữ liệu, được ghi vào tệp database.sql trong dự án.

Lệnh này có chủ đích bỏ lại mã nguồn lõi của WordPress (môi trường chạy cục bộ của bạn sẽ cung cấp phiên bản phù hợp), wp-config.php (tệp lưu trữ mật khẩu cơ sở dữ liệu của trang web trực tuyến), và bất kỳ tệp phương tiện nào đã được chuyển tải sang bộ nhớ đối tượng (object storage).

Mỗi lần chạy sẽ in ra chính xác những gì đã được tải xuống và những gì được giữ lại, kèm theo số lượng. Nếu bạn chỉ muốn lấy các tệp, hãy thêm --no-database.

Bạn đã có sẵn dự án và chỉ muốn cập nhật bản mới nhất? Hãy chạy zinnector pull bên trong thư mục dự án đó.

4. Chạy cục bộ với nội dung thực tế

zinnector dev --runtime docker

Trên môi trường chạy Docker, lệnh này sẽ nhập tệp database.sql, viết lại URL của trang web thành địa chỉ cục bộ của bạn, và mở trang web với nội dung thực tế của khách hàng bên trong đó. Hãy đăng nhập bằng chính các tài khoản WordPress của trang web đó.

Môi trường chạy mặc định — WordPress Playground, không yêu cầu Docker — có tốc độ khởi động nhanh hơn và không nhập cơ sở dữ liệu; hệ thống sẽ thông báo cho bạn biết thay vì âm thầm khởi động với một trang trống. Hãy sử dụng môi trường này khi bạn đang làm việc với mã nguồn và không cần nội dung.

5. Quản lý bản sao bạn đã được cấp

database.sql là cơ sở dữ liệu của một trang web đang hoạt động trực tuyến. Zinnector® sẽ tự động thêm tệp này vào tệp .gitignore của dự án ngay khi tạo ra nó, nhờ đó một lệnh git add -A do sơ ý sẽ không thể vô tình đưa dữ liệu khách hàng của ai đó lên kho lưu trữ (repository). Hãy giữ nguyên dòng đó và xóa tệp này đi khi công việc đã hoàn tất.

Những việc cộng tác viên có thể và không thể làm

| | Người xem | Người chỉnh sửa | Quản lý | |---|---|---|---| | Xem trang web và các cài đặt của trang web | ✔ | ✔ | ✔ | | Thay đổi tệp, sử dụng wp-admin, triển khai | | ✔ | ✔ | | Tải trang web về, bao gồm cả cơ sở dữ liệu | | ✔ | ✔ | | Khôi phục bản sao lưu đè lên trang web trực tuyến | | | ✔ | | Xóa trang web | | | | | Xem hóa đơn thanh toán hoặc hóa đơn tài chính | | | | | Truy cập các trang web khác của chủ sở hữu | | | |

Ba hàng cuối cùng đều để trống đối với mọi vai trò. Đây không phải là một cài đặt.

Chấm dứt quyền truy cập

Chủ sở hữu mở phần Bảo mật của trang web và chọn Thu hồi bên cạnh tên của người đó. Thao tác này có hiệu lực ngay lập tức: lệnh Zinnector® tiếp theo mà lập trình viên đó chạy sẽ không thể nhìn thấy trang web nữa, và bất kỳ công cụ nào khác mà họ đang nắm giữ cũng vậy.

Thời hạn hết hạn sẽ thực hiện việc tương tự vào một ngày cụ thể mà không cần ai phải nhớ thủ công. Nếu bạn đã thiết lập thời hạn khi chia sẻ trang web, công việc của bạn coi như đã hoàn tất.

Khi xảy ra lỗi

• zinnector sites không hiển thị gì. Lời mời vẫn chưa được chấp nhận, hoặc quyền truy cập đã bị thu hồi hoặc hết hạn. Hãy yêu cầu chủ sở hữu kiểm tra phần Bảo mật của trang web — lời mời đang chờ xử lý sẽ được liệt kê ở đó.
• zinnector pull thông báo trang web không có bản sao lưu gần đây. Lệnh kéo sẽ tạo một bản sao lưu mới nếu gói dịch vụ cho phép và sẽ hỏi trước. Nếu gói dịch vụ không bao gồm tính năng sao lưu theo yêu cầu, hãy tăng giá trị tham số --max-age để chấp nhận bản sao lưu cũ hơn.
• zinnector dev khởi động một trang WordPress trống. Bạn đang sử dụng môi trường chạy Playground, vốn không nhập cơ sở dữ liệu. Hãy chạy lệnh zinnector dev --runtime docker.
• Trang web cục bộ liên tục chuyển hướng về tên miền trực tuyến. Quá trình nhập sẽ viết lại URL của trang web; nếu bước đó thất bại, lệnh sẽ thông báo và in ra dòng lệnh wp search-replace để bạn chạy.

Các lỗi khác và cách khắc phục: Khắc phục sự cố Zinnector®.