Eiro
Documentation

Mục lục

    Giới thiệu

    Eiro là theme dành cho Ghost CMS, được thiết kế theo phong cách tối giản và rất phù hợp đối với các website là blog cá nhân.

    Theme có tất cả những tính năng cần thiết cho blogging, bao gồm Tags Page, Authors Page, Disqus Comments,... và còn nhiều tính năng khác nữa.

    Cài đặt Ghost theme

    Các bước đơn giản để cài đặt Ghost theme

    1. Đầu tiên, bạn cần login vào trang quản trị của blog. Nếu chưa có blog, hãy tạo cho mình một website trước (mình khuyến khích mua domain trên Namecheap và mua VPS trên DigitalOcean).
    2. Khi website của bạn sẵn sàng, hãy đăng nhập vào trang quản trị Dashboard
      https://yourdomain.com/ghost
    3. Chọn mục Design từ Dashboard và tìm mục chứa theme.
    4. Click Upload a theme.
    5. Kéo file Eiro.zip vào mục upload và đợi quá trình hoàn tất.
    6. Khi quá trình upload hoàn thành, click chọn Activate để kích hoạt theme.

    Thiết lập menu

    Từ Dashboard > Design, bạn cũng có thể thêm, thay đổi và chỉnh thứ tự các phần tử menu.

    Menu Settings

    Để thêm phần tử menu từ trong hay ngoài blog, bạn hãy đặt tên cho phần tử menu đó, thêm đường link và cuối cùng nhấn Save.

    Lưu ý: Bạn nhớ nhé, nếu bạn không nhấn Save thì sẽ không có thay đổi nào được lưu cả.

    Bài viết nổi bật

    Ghost CMS cho phép tùy chọn các bài viết thông thường thành bài viết nổi bật và tùy biến giao diện riêng cho những bài viết này.

    Featured Post

    Để kích hoạt giao diện cho những bài viết nổi bật trong theme, bạn vào Post settings > Feature this post.

    Thiết lập Disqus

    Ghost CMS hiện tại chưa được tích hợp sẵn hệ thống comment nào, vì vậy muốn bổ sung tính năng bình luận cho bài viết, bạn cần sử dụng hệ thống comment của bên thứ ba.

    Disqus Comments là nền tảng cho phép bạn nhúng bình luận vào bài viết, ngoài ra người dùng cũng có thể vote, react cảm xúc trên bài viết đó.

    Để sử dụng Disqus, đầu tiên bạn hãy truy cập:
    partials/disqus_comments.hbs
    Sau đó thay đổi giá trị sau thành url của riêng bạn.

    
    					https://YOURDOMAIN-COM.disqus.com/embed.js
    				

    Trước tiên bạn hãy đăng ký một tài khoản Disqus và xem hướng dẫn nhanh từ Diqus qua link dưới đây:

    help.disqus.com

    Hãy liên hệ với mình nếu bạn gặp khó khăn trong việc cài đặt Disqus nhé.

    Note: Ngoài Disqus, bạn có thể sử dụng các hệ thống comment khác như Cove, Commento. Tuy nhiên, đây đều là các ứng dụng trả phí.

    Thêm Authors Page

    Authors page là trang chứa danh sách các tác giả của blog. Để tạo Authors page, bạn mở Dashboard > Pages và tạo 1 trang mới với tên là Authors

    Sau đó tìm trong mục Page settings > Template rồi chọn template là Authors.

    Authors Page

    Lúc này dữ liệu về các tác giả của blog sẽ được tự động thêm vào trang đó.

    Thêm Tags Page

    Tags page là trang chứa danh sách các thẻ tags của blog. Để tạo Tags page, bạn mở Dashboard > Pages và tạo 1 trang mới với tên là Tags

    Sau đó tìm trong mục Page settings > Template rồi chọn template là Tags.

    Tags Page

    Lúc này dữ liệu về các thẻ tags của blog sẽ được tự động thêm vào trang đó.

    Thiết lập Subscribe Form

    Subscribe Form giúp bạn thu thập email của độc giả muốn theo dõi blog.

    Theme đã tích hợp sẵn Subscribe Form cho bạn thông qua nền tảng Mailchimp. Để form có thể hoạt động được:

    1. Bạn cần đăng ký tài khoản Mailchimp. Sau đó truy cập Audience > Signup forms > Embedded forms sau đó tìm kiếm dòng code có dạng như sau:

    
    					<form action="YOUR FORM'S ACTION LINK" >           
    				
    Subscribe Form

    2. Copy đoạn script dưới đây vào mục Dashboard > Code Injections > Site Footer.

    
    					<script>
    					var frm = document.getElementById("form-signup") || null;
    					if(frm) {
    						frm.action = "YOUR FORM'S ACTION LINK" 
    					}
    					</script>           
    				

    3. Thay thế đường link YOUR FORM'S ACTION LINK đã tìm được ở Bước 1 vào phần tương ứng ở Bước 2 để kích hoạt Subscribe Form. Đoạn script mới thường có dạng như ví dụ dưới đây:

    
    					<script>
    					var frm = document.getElementById("form-signup") || null;
    					if(frm) {
    						frm.action = "https://cuongnc.us2.list-manage.com/subscribe/post?u=e8fb2f62f44c5b4f5e0d22663&id=f7d82b787d" 
    					}
    					</script>           
    				

    Tạo Content API Key

    Bạn cần Content API Key để sử dụng đầy đủ tính năng của theme, cũng như liên kết với các ứng dụng mà Ghost CMS hỗ trợ. Các bước tạo Content API Key:

    Content API Key Creation
    1. Từ trang quản trị, click Integrations.
    2. Sau đó, click Add custom integration.
    3. Đặt tên cho custom integration và click nút Create.
    4. Lúc này Content API Key đã được tạo rồi. Để sao chép, bạn chỉ cần di chuột qua đoạn mã và click Copy là được.

    Việc sử dụng Content API Key được hướng dẫn ở phần dưới đây.

    Kích hoạt Content API Key

    Để kích hoạt Content API Key, thêm dòng code sau trong mục Code Injection > Blog Footer.

    
    					<script>
    					var ghosthunter_key = 'xxxxx';
    					// optional: set your custom ghost_root url, default is `"/ghost/api/v2"`
    					var ghost_root_url = "/ghost/api/v2"    
    					</script>           
    				

    Thay thế xxxxx thành đoạn mã Content API Key mà bạn đã copy trước đó. Đoạn code mới mà bạn nhận được sẽ tương tự nhau sau:

    
    					<script>
    					var ghosthunter_key = '2f6e9debccad3be996edcc1ce4';
    					// optional: set your custom ghost_root url, default is `"/ghost/api/v2"`
    					var ghost_root_url = "/ghost/api/v2"    
    					</script>           
    				
    Content API Key Activation

    Lưu ý: Thao tác trên giúp bạn kích hoạt tính năng tìm kiếm các bài viết trong website. Hayc chắc chắn các dòng code đều nằm trong thẻ <script></script> nhé. Nếu không code sẽ không thể hoạt động được.

    Changelog

    Thời gian trôi đi và Eiro cũng càng ngày càng trở nên hoàn thiện hơn. Dưới đây là từng sự thay đổi, cải tiến cho dù là nhỏ bé nhất của Eiro tính từ ngày 16/02/2021

    Vì mục đích phát triển, mục này sẽ được cuongnc.com ghi chú bằng tiếng Anh.

    1.0.0 (Feb 16, 2021)
    -- Initial release