Gắn thương hiệu cho trang và dùng tên miền riêng

Hướng dẫn thao tác

Dành cho:: Nhà xuất bản và marketer, Người vận hành máy chủ
Cần quyền:: forms:edit
Trong ứng dụng:: Biểu mẫu và trang, rồi Thương hiệu và tên miền

Thương hiệu của bạn (tên đơn vị phát hành, logo, màu và phông chữ) định kiểu cho mọi trang công khai mà ReputeCast phục vụ cho một không gian làm việc: trang đăng ký và trang xác nhận, trung tâm tùy chọn, trang hủy đăng ký, trang lưu trữ, website và các landing page. Biểu mẫu đăng ký nhúng dùng màu nhấn của thương hiệu và phông chữ của chính site bạn. Với tên miền riêng cho bản tin, các trang trả lời tại gốc một địa chỉ của bạn, ví dụ https://news.acme.io/subscribe, thay vì dưới /p/<workspace>/ trên máy chủ ReputeCast.

Trước khi bắt đầu

Bạn cần quyền forms:edit. Chủ sở hữu, Quản trị viên và Biên tập viên có quyền này.
Để dùng tên miền tùy chỉnh, bạn cần quyền truy cập bản ghi DNS của tên miền và một người vận hành máy chủ có thể cấp chứng chỉ TLS cho tên miền đó trên reverse proxy. ReputeCast không tự cấp chứng chỉ.

Thiết lập thương hiệu

Mở Biểu mẫu và trang, rồi Thương hiệu và tên miền.
Nhập Tên đơn vị phát hành, tối đa 80 ký tự. Tên này đứng đầu mọi trang công khai và ban đầu là tên của không gian làm việc.
Tải lên Logo: SVG, PNG, JPEG, GIF hoặc WebP, tối đa 256 KB. Một tệp SVG hoặc PNG 200 px là đủ. Tệp SVG có tập lệnh, thuộc tính sự kiện hoặc nội dung nhúng (<foreignObject>, <iframe>, <object>, <embed>) sẽ bị từ chối chứ không được làm sạch: hãy xuất lại thành SVG thuần hoặc PNG. Logo cũng là favicon của website. Khi không có logo, các trang hiện chữ cái đầu của tên đơn vị phát hành trên một ô nền tối.
Đặt Màu nhấn và Nền trang bằng mã màu hex, ví dụ #4338CA và #F5F3FF (giá trị mặc định). Xem cách màu chữ luôn dễ đọc.
Chọn Phông chữ: IBM Plex Sans (mặc định), Mặc định của hệ thống hoặc Phông chữ web tùy chỉnh. Phông chữ tùy chỉnh cần tên họ phông như trong CSS, ví dụ Inter, và một địa chỉ https:// kết thúc bằng .woff2 hoặc .woff.
Nếu muốn, nhập địa chỉ Chính sách quyền riêng tư, ví dụ https://acme.io/privacy. Các trang hiển thị nó thành liên kết Quyền riêng tư ở chân trang, và cụm từ “chính sách quyền riêng tư” trong nội dung đồng ý của biểu mẫu dẫn tới địa chỉ này.
Bật hoặc tắt Hiện "Gửi bằng ReputeCast" ở chân trang · không bắt buộc, tắt bất cứ lúc nào. Mặc định tùy chọn này bật.
Kiểm tra bản xem trước và chọn Lưu thương hiệu. Mọi trang công khai dùng thương hiệu mới từ lần truy cập tiếp theo.

Cách màu chữ luôn dễ đọc

ReputeCast giữ chữ trên các trang công khai ở độ tương phản 4,5:1 theo chuẩn WCAG 2.2 AA, dù bạn chọn màu nào:

Nếu chữ trắng trên màu nhấn của bạn có độ tương phản dưới 4,5:1, các nút chuyển sang dùng chữ tối.
Nếu màu nhấn quá nhạt để dùng cho liên kết, liên kết dùng một sắc độ đậm hơn của màu đó, đủ 4,5:1 trên nền trắng và trên nền trang của bạn.
Màu duy nhất ReputeCast từ chối là nền trang tối đến mức chữ xám ở chân trang có độ tương phản dưới 4,5:1. Hãy chọn nền sáng hơn.

Thông báo sau khi lưu cho biết màu nào đã được điều chỉnh và vì sao.

Dùng tên miền riêng

Trong Tên miền tùy chỉnh, nhập tên miền mà không có https:// hay đường dẫn, ví dụ news.acme.io, rồi chọn Lưu thương hiệu. Mỗi tên miền chỉ phục vụ được một không gian làm việc, và không được trùng với địa chỉ của chính máy chủ ReputeCast.
Tại nhà cung cấp DNS, thêm một trong các bản ghi sau. Ứng dụng hiển thị giá trị chính xác cho tên miền của bạn.
- Với tên miền con như news.acme.io (trường hợp thường gặp): một bản ghi CNAME từ news.acme.io tới tên máy chủ trong URL công khai của máy chủ, ví dụ reputecast.acme.io.
- Với tên miền gốc như acme.io, vốn không thể có CNAME: các bản ghi A và AAAA có cùng địa chỉ với tên máy chủ trong URL công khai của máy chủ.
- Để chứng minh quyền sở hữu theo cách khác: một bản ghi TXT tên _reputecast.news.acme.io có giá trị là reputecast-verify= theo sau là 24 ký tự.
Bản ghi TXT chỉ chứng minh tên miền thuộc về bạn. Khách truy cập vẫn cần đến được máy chủ của bạn, nên các bản ghi của chính tên miền phải trỏ tới máy chủ hoặc tới reverse proxy.
Chọn Kiểm tra DNS ngay. Khi bản ghi còn thiếu, tên miền hiện “Đang chờ DNS”; bản ghi sai hiện “Kiểm tra DNS thất bại” kèm lý do, ví dụ một CNAME trỏ sang nơi khác. Thay đổi DNS có thể mất tới một giờ mới hiện ra. ReputeCast tự kiểm tra lại mỗi 10 phút.
Nhờ người vận hành máy chủ cấp chứng chỉ cho tên miền trên reverse proxy và chuyển nguyên header Host gốc. Xem tên miền tùy chỉnh trong hướng dẫn reverse proxy.

Những gì thay đổi khi tên miền được xác minh

Chỉ tên miền đã xác minh mới phục vụ trang. Khi đã xác minh:

Các trang công khai trả lời tại gốc tên miền: /subscribe, /preferences, /unsubscribe, /archive, website, các landing page, cùng các trang của Tăng trưởng và Kiếm tiền. Những trang này vẫn hoạt động dưới /p/<workspace>/ trên máy chủ của bạn.
Liên kết canonical, sitemap và địa chỉ trang hiển thị trong ứng dụng dùng tên miền này.
Tập lệnh của biểu mẫu đăng ký tải từ /p/<workspace>/forms/ trên tên miền. Hãy sao chép lại mã nhúng để site của bạn dùng địa chỉ mới; địa chỉ cũ vẫn hoạt động.
Liên kết trong email (hủy đăng ký, tùy chọn, xác nhận và xem trực tuyến) vẫn dùng URL công khai của máy chủ.
Khi không bật website, gốc tên miền chuyển hướng tới /subscribe.

Tên miền đã xác minh được kiểm tra lại mỗi ngày một lần. Nếu một lần kiểm tra thất bại, tên miền vẫn phục vụ trang và hiện “Lần kiểm tra gần nhất thất bại: … Sẽ sớm kiểm tra lại.”; lần thất bại thứ hai sẽ dừng tên miền cho đến khi DNS được sửa. Khi website đang bật, người có quyền website:manage nhận thông báo khi tên miền không còn vượt qua kiểm tra hoặc chứng chỉ của nó gặp lỗi.

Dành cho người vận hành: chỉ cấp chứng chỉ cho tên miền đã xác minh

ReputeCast trả lời GET /p/_/tls-check?domain=<host> bằng 200 khi host là một tên miền tùy chỉnh đã xác minh và 404 trong các trường hợp khác. Hãy trỏ kiểm tra TLS theo yêu cầu (on-demand TLS) tới endpoint này, ví dụ ask http://localhost:8080/p/_/tls-check của Caddy, để proxy chỉ xin chứng chỉ cho những tên miền mà một không gian làm việc đã xác minh. ReputeCast định tuyến yêu cầu theo header Host, nên proxy phải giữ nguyên header này. Cấu hình đầy đủ có trong reverse proxy và TLS.

Kiểm tra kết quả

Mở https://<your domain>/subscribe. Trang hiện logo, màu và phông chữ của bạn, và trình duyệt hiện chứng chỉ hợp lệ.
Trong ứng dụng, địa chỉ trang đăng ký và trang lưu trữ trong Biểu mẫu và trang, rồi Trang bắt đầu bằng tên miền của bạn.

Khắc phục sự cố

“Hãy dùng một tên miền như news.acme.io, không kèm https:// hay đường dẫn.” Bỏ phần giao thức, đường dẫn và cổng.
“… đang phục vụ các trang của một không gian làm việc khác. Hãy gỡ tên miền ở đó trước.” Mỗi tên miền chỉ phục vụ được một không gian làm việc.
“Chưa có CNAME từ … đến …” Bản ghi chưa hiện ra. Chờ tối đa một giờ rồi chọn Kiểm tra DNS ngay.
Tên miền đã xác minh nhưng trình duyệt báo lỗi chứng chỉ. Proxy chưa có chứng chỉ cho tên miền. Hãy nhờ người vận hành thiết lập on-demand TLS hoặc một chứng chỉ cho tên miền đó.
“Tệp SVG này chứa mã script hoặc nội dung nhúng.” Hãy xuất lại logo thành SVG thuần hoặc PNG.
“Logo nặng … KB; giới hạn là 256 KB.” Hãy dùng tệp nhỏ hơn. Một tệp SVG hoặc PNG 200 px là đủ.