FastComments.com

Add Members-Only Live Commenting to ghost Sites

Με το FastComments μπορούμε εύκολα να προσθέσουμε ζωντανά σχόλια αποκλειστικά για μέλη σε οποιονδήποτε ιστότοπο που έχει κατασκευαστεί με το Ghost.

Θα μπορούμε να εισάγουμε αυτόματα τα ονόματα χρήστη των μελών, τα avatar τους και να ρυθμίσουμε τις ειδοποιήσεις απάντησης σχολίων.

Σημείωση ότι αυτό το σεμινάριο απαιτεί λογαριασμό FastComments. Συνιστάται να εγγραφείτε πρώτα και μετά να επιστρέψετε εδώ. Μπορείτε να δημιουργήσετε έναν λογαριασμό εδώ.

Σε αυτό το σεμινάριο θα στοχεύσουμε σε ένα blog που έχει κατασκευαστεί με το Ghost, αλλά με λίγη τεχνογνωσία οι ίδιες οδηγίες ισχύουν για οποιονδήποτε τύπο ιστότοπου.

Αυτό το σεμινάριο ξεκινά από την οπτική ενός χρήστη που είναι πολύ νέος στο Ghost. Χρήστες με εμπειρία στην επεξεργασία των θεμάτων τους μπορούν να παραλείψουν στο Step 4.

Εάν αντιμετωπίζετε προβλήματα, μη διστάσετε να στείλετε το εξαγόμενο πρότυπο του θέματος σας στον εκπρόσωπο υποστήριξής σας (παραμένει απαραίτητο να ολοκληρωθούν τα βήματα 1 - 5).

Βήμα 1: Κατεβάστε το θέμα σας Internal Link

Για να προσθέσετε σωστά το FastComments στο Ghost, πρέπει να επεξεργαστούμε τα αρχεία του θέματος.

Ας ξεκινήσουμε κατεβάζοντας το τρέχον ή το επιθυμητό θέμα σας.

Μεταβείτε στον πίνακα ελέγχου του ιστότοπού σας και κάντε κλικ στο εικονίδιο ρυθμίσεων κάτω αριστερά:

Άνοιγμα ρυθμίσεων
Άνοιγμα ρυθμίσεων

Στη συνέχεια επιλέξτε την επιλογή Design:

Επιλέξτε Σχεδίαση
Επιλέξτε Σχεδίαση

Παρότι τεχνικά δεν αλλάζουμε το θέμα, κάντε κλικ στο Change Theme κάτω αριστερά:

Αλλαγή Θέματος
Αλλαγή Θέματος

Στο πάνω δεξιό μέρος επιλέξτε το Advanced:

Επιλέξτε Προχωρημένα
Επιλέξτε Προχωρημένα

...και στη συνέχεια κατεβάστε το τρέχον ή το επιθυμητό θέμα σας:

Λήψη Θέματος
Λήψη Θέματος

Βήμα 2: Εγκαταστήστε το θέμα σας τοπικά Internal Link


Τώρα που κατεβάσαμε το αρχείο zip, αποσυμπιέστε το σε έναν φάκελο. Έχω κατεβάσει το προεπιλεγμένο casper.zip και το αποσυμπίεσα στο Downloads\casper στα Windows.

Στη συνέχεια, βεβαιωθείτε ότι έχετε εγκατεστημένη την LTS ή νεότερη έκδοση του NodeJS. Μπορείτε να την κατεβάσετε εδώ: https://nodejs.org/en/download/

Μόλις εγκατασταθεί το NodeJS, θα πρέπει να εγκαταστήσετε έναν επεξεργαστή κώδικα.

Συστήνουμε (και χρησιμοποιούμε) το Webstorm, το οποίο μπορείτε να αποκτήσετε εδώ με δοκιμή 30 ημερών (δεν απαιτείται πιστωτική κάρτα): https://www.jetbrains.com/webstorm/

Η επόμενη καλύτερη δωρεάν επιλογή πιθανώς είναι το Visual Studio Code: https://code.visualstudio.com/download

Αφού ρυθμίσετε τον επεξεργαστή σας και ανοίξετε τον φάκελο του θέματος στον επεξεργαστή, ανοίξτε το τερματικό στο IDE και εκτελέστε:

Εγκατάσταση του Θέματος
Copy Copy
1
2npm install
3

Η επιτυχής έξοδος θα μοιάζει με αυτή (μπορείτε να αγνοήσετε τις προειδοποιήσεις):

Επιτυχής έξοδος npm install
Επιτυχής έξοδος npm install

Αυτό θα ρυθμίσει τις εξαρτήσεις του θέματος για τις επόμενες εντολές που θα εκτελέσουμε. Επίσης, η εξαγωγή εξαρτάται από το να είναι εγκατεστημένες οι εξαρτήσεις του θέματος, διαφορετικά η επανεισαγωγή δεν θα λειτουργήσει σωστά.


Βήμα 3: Ονομάστε το νέο θέμα Internal Link


Τώρα που έχουμε το θέμα ανοιχτό στον επεξεργαστή μας, ανοίξτε το package.json και αλλάξτε το πεδίο name σε κάτι άλλο. Στη δική μας περίπτωση απλώς προσθέτουμε -fastcomments στο τέλος:

Μετονομασία Θέματος
Μετονομασία Θέματος

If you're using an IDE it will auto-save after you make this change.


Βήμα 4: Ανοίξτε το πρότυπο ανάρτησης Internal Link

Τώρα θα ανοίξουμε το πρότυπο που χρησιμοποιείται για τα άρθρα του ιστολογίου μας. Ονομάζεται post.hbs:

Άνοιγμα του post.hbs
Άνοιγμα του post.hbs

Βήμα 5: Προσθέστε τον κώδικα του FastComments Internal Link

Στη συνέχεια πρέπει να εντοπίσουμε πού να προσθέσουμε τον κώδικα του widget του FastComments.com.

Αν χρησιμοποιείτε το προεπιλεγμένο θέμα casper, θα δείτε μια ενότητα σαν αυτή στη γραμμή 82:

Απενεργοποιημένη Ενότητα Σχολίων
Απενεργοποιημένη Ενότητα Σχολίων

Αν χρησιμοποιείτε άλλα θέματα, δεν θα δείτε αυτό, και θα χρειαστεί να προσθέσετε αυτόν τον κώδικα μετά το τελευταίο </section>:

Παράδειγμα Ενότητας
Copy Copy
1
2<section class="article-comments gh-canvas">
3</section>
4

Πρέπει να έχετε κάτι σαν αυτό έτοιμο:

Πρότυπο Έτοιμο για Κώδικα Σχολίων
Πρότυπο Έτοιμο για Κώδικα Σχολίων

Μόλις είστε έτοιμοι, αντιγράψτε τον κώδικα του widget του FastComments.com:

Απόσπασμα Κώδικα Σχολίων FastComments.com για Ghost
Copy Copy
1
2<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
3<div id="fastcomments-widget"></div>
4<script>
5 (function () {
6 let simpleSSO = null;
7
8 {{#if access}}
9 {{#if @member}}
10 simpleSSO = {
11 id: '{{ @member.uuid }}',
12 email: '{{@member.email}}',
13 username: '{{@member.name}}',
14 avatar: '{{ @member.avatar_image }}',
15 optedInNotifications: true,
16 optedInSubscriptionNotifications: true,
17 displayLabel: '{{@member.labels}}'
18 }
19 {{/if}}
20 {{/if}}
21
22 FastCommentsUI(document.getElementById('fastcomments-widget'), {
23 tenantId: "demo",
24 urlId: window.location.pathname,
25 allowAnon: false,
26 simpleSSO: simpleSSO
27 });
28 })();
29</script>
30

...και θα πρέπει να μοιάζει έτσι:

Προσθήκη Κώδικα Σχολίων FastComments.com
Προσθήκη Κώδικα Σχολίων FastComments.com

Ο κώδικας ολοκληρώθηκε. Τώρα απλώς πρέπει να επανεισάγουμε το θέμα μας!

Βήμα 6: Εξαγάγετε το θέμα σας Internal Link

Τώρα πρέπει να συσκευάσουμε ξανά τα αρχεία του θέματος σε ένα αρχείο zip. Για να το κάνετε αυτό, χρησιμοποιήστε τις ενσωματωμένες λειτουργίες στο Ghost.

Ανοίξτε ξανά το τερματικό του επεξεργαστή σας και εκτελέστε npm run zip.

Εξαγωγή του Θέματος
Εξαγωγή του Θέματος

Αυτό θα συσκευάσει το θέμα σε ένα αρχείο zip στο dist/casper-fastcomments.zip (αν αυτό είναι το όνομα που έχετε δώσει στο θέμα στο Step Three).

Βήμα 7: Ανεβάστε το θέμα στο Ghost Internal Link

Επιστρέφοντας στον πίνακα ελέγχου του Ghost, ας ανεβάσουμε το θέμα μας:

Ανεβάστε το Θέμα σας
Ανεβάστε το Θέμα σας

Σε εμένα, το αρχείο zip βρίσκεται στην παρακάτω τοποθεσία. Σημειώστε το φάκελο dist:

Επιλέξτε το Zip για Ανέβασμα
Επιλέξτε το Zip για Ανέβασμα

Θυμηθείτε να ενεργοποιήσετε το πρόσφατα ανεβασμένο θέμα σας (το Ghost θα σας ρωτήσει).

Επιτυχία! Internal Link

Now we should have FastComments Live Commenting enabled for our members!

Επιτυχία!
Επιτυχία!

Συγχαρητήρια για τη ρύθμιση του FastComments με το Ghost! Αν αντιμετωπίσατε Σφάλμα Τομέα (Domain Error), ή θέλετε να μάθετε πώς να προσαρμόσετε την περιοχή σχολίων, διαβάστε παρακάτω!


Προσαρμογή Internal Link

Το FastComments έχει σχεδιαστεί για να προσαρμόζεται ώστε να ταιριάζει με τον ιστότοπό σας.

Εάν θέλετε να προσθέσετε προσαρμοσμένο στυλ ή να τροποποιήσετε τη διαμόρφωση, Δείτε την Τεκμηρίωση Προσαρμογής μας για να μάθετε πώς.