grEPP 2 - Εγκατάσταση
- Φτιάχνετε έναν φάκελο
whmcs/modules/registrars/greppκαι βάζετε εκεί τα περιεχόμενα του φακέλουmodule. - Μετακινείτε το φάκελλο
grepp/resources/langστον φάκελλοwhmcs/lang/overrides. - Στον φάκελλο
whmcs/modules/serversβάζετε τα περιεχόμενα του καταλόγουservers, αν σκοπεύετε να χρησιμοποιήσετε αυτές τις λειτουργίες.
Προσοχή: Αποφύγετε να κάνετε τροποποιήσεις μέσα στον φάκελο whmcs/modules/registrars/grepp/vendor. Υπάρχει πρόβλεψη τα αρχεία που τυχόν χρειάζονται τροποποιήσεις, να τα έχετε στον root φάκελο του module.
Προσοχή: Σε περίπτωση αναβάθμισης από παλαιότερη έκδοση, πρέπει να κάνετε οverwrite ΟΛΑ τα αρχεία (php/xml), εκτός από το greppcore.ini σε περίπτωση που το έχετε τροποποιήσει.
Έλεγχος συμβατότητας
Μέσα στον κατάλογο grepp θα βρείτε τον κατάλογο grepptest. Εκεί υπάρχει ένα βοηθητικό script το οποίο κάνει κάποιους ελέγχους συμβατότητας και επικοινωνίας, και είναι το πρώτο πράγμα που θα πρέπει να κάνετε για να είστε σίγουροι πως αν παρουσιαστεί κάποιο πρόβλημα θα είναι κάποια ρύθμιση του module ή του WHMCS, και όχι του server σας.
Το grepptest το καλείτε ως http://www.yoursite.gr/whmcs/modules/registrars/grepp/grepptest και κάνει τους παρακάτω ελέγχους:
- Εμφάνιση των ΙΡ που χρησιμοποιείτε οι οποίες πρέπει να είναι δηλωμένες στο ΙΤΕ και στην άδεια του module
- Έλεγχος αν οι πόρτες 700 (ΕΡΡ) και 800 (WHOIS) είναι ανοιχτές για εξερχόμενες συνδέσεις
- Έλεγχο αν υπάρχει επικοινωνία με τον ΕΡΡ Proxy του ΙΤΕ
- Έλεγχο αν υπάρχει επικοινωνία με τον WHOIS Server του ΙΤΕ
Αν κάποιος έλεγχος αποτύχει, το module δεν πρόκειται να δουλέψει αν δεν φτιάξετε το πρόβλημα και δεν υπάρχει νόημα να συνεχίσετε την εγκατάσταση. Το grepptest επιστρέφει αναλυτικά σχόλια για το τι πρέπει να κάνετε αν εμφανιστεί κάποιο πρόβλημα.
Παραμετροποίηση
Μετάβαση από παλαιότερες εκδόσεις
Αν χρησιμοποιείτε μέχρι τώρα την έκδοση από 1.57 και παλαιότερη, λάβετε υπόψη σας τα παρακάτω:
- Τα περιεχόμενα του φακέλλου
modules/registrars/greppπρέπει να διαγραφούν. Το μόνο που ίσως χρειάζεται να σημειώσετε είναι οι IPs που έχετε ορίσει στοgrwhois.php. - Θα πρέπει να σβήσετε το
grepp_widgets.phpαπό τον φάκελλοmodules/widgets. - Θα πρέπει να σβήσετε τις μεταβολές που τυχόν έχετε κάνει στο template
orderforms/xxxx/configuredomains.tplσύμφωνα με τις οδηγίες των παλαιοτέρων εκδόσεων. - Θα πρέπει να σβήσετε τις αλλαγές που τυχόν έχετε κάνει στο
resources/domains/additionaldomainfields.phpσχετικά με τοgrdomaindescriptionκαιgrcomaincontactlegalnameσύμφωνα με τις οδηγίες των παλαιοτέρων εκδόσεων. - Θα πρέπει να ξαναελέγξετε το template
clieantareadomaincontactinfoπως συμβαδίζει με τις οδηγίες που δίνονται παρακάτω.
greppcore.ini
Προκειμένου να αποφύγω ένα τεράστιο τμήμα για τις ρυθμίσεις του module μέσα στο WHMCS και να μείνει αυτό το κομμάτι όσο πιο minimal γίνεται, χρησιμοποίησα τη μέθοδο του ini αρχείου για τις βασικές παραμέτρους λειτουργίας οι οποίες δεν χρειάζεται να αλλάζουν συνήθως ποτέ.
Το greppcore.ini, όπως είναι προφανές και από το όνομά του, είναι ένα αρχείο που περιέχει τις βασικές ρυθμίσεις επικοινωνίας με το ΙΤΕ, καθώς και του logging. Το αρχείο βρίσκεται στον root κατάλογο του module, αλλά μπορείτε να το βάλετε όπου θέλετε αφού ορίσετε το path στις ρυθμίσεις του module, κατά προτίμηση έξω από το directory tree του site.
Όπου χρησιμοποιούνται κατάλογοι ή ονόματα αρχείων, το path είναι πάντα relative με το path που έχει οριστεί στις ρυθμίσεις του module μέσα στο WHMCS.
Είναι επίσης πολύ σημαντικό να μην αλλάξετε τα ονόματα των sections (url, certificates, language, κλ) και των μεταβλητών (reg, uat, κλπ).
| Μεταβλητή | Τιμές | Σχόλια |
|---|---|---|
| urls.reg | url | Το url του EPP Proxy στο περιβάλλον παραγωγής του ΙΤΕ |
| urls.uat | url | Το url του EPP Proxy στο περιβάλλον δοκιμών του ΙΤΕ |
| certificates.reg | file | Το πιστοποιητικό του περιβάλλοντος παραγωγής. Αν δεν οριστεί τιμή ή το αρχείο είναι μη προσπελάσιμο, θα χρησιμοποιηθεί το default από τον κατάλογο vendor/liagkos/greppcore/src/certificates. |
| certificates.uat | file | Το πιστοποιητικό του περιβάλλοντος δοκιμών. Αν δεν οριστεί τιμή ή το αρχείο είναι μη προσπελάσιμο, θα χρησιμοποιηθεί το default από τον κατάλογο vendor/liagkos/greppcore/src/certificates. |
| language.default | en/el | Η γλώσσα στην οποία θα στέλνει μηνύματα στον χρήστη το ΙΤΕ, en=αγγλικά και el=ελληνικά. |
| templates.files | dir | Εναλλακτική τοποθεσία των xml templates για τα requests. Αν υπάρχει σε αυτόν τον κατάλογο template με ίδιο όνομα κάποιου υπάρχοντος στο vendor/liagkos/greppcore/src/xml, θα αγνοήσει το δεύτερο. Αν δεν οριστεί τιμή ή ο φάκελλος είναι μη προσπελάσιμος, θα χρησιμοποιηθεί το default path vendor/liagkos/greppcore/src/xml. |
| templates.compiled | dir | Τοποθεσία των compiled xml templates (smarty). Αν δεν οριστεί τιμή ή ο φάκελλος είναι μη προσπελάσιμος, θα χρησιμοποιηθεί το default path vendor/liagkos/greppcore/src/xml/compiled. |
| log.file | file | Τοποθεσία και όνομα του text log file, ή off αν δεν θέλετε log file. Αν ο κατάλογος είναι μη προσπελάσιμος, θα χρησιμοποιηθεί το default greppcore.log μέσα στον φάκελλο που βρίσκεται το greppcore.ini. Αν δεν υπάρχει τιμή, ΔΕΝ θα χρησιμοποιηθεί log file. |
| log.level | DEBUG | Raw XML Request/Replies, JESSION, Login/Logout, Compact Requests/Replies, όλα τα σφάλματα (επικοινωνίας, epp, smarty, αρχεία) |
| log.level | INFO | Login/Logout, Compact Requests/Replies, όλα τα σφάλματα (επικοινωνίας, epp, smarty, αρχεία) |
| log.level | NOTICE | Compact Requests/Replies, όλα τα σφάλματα (επικοινωνίας, epp, smarty, αρχεία) |
| log.level | ERROR | Μόνο τα σφάλματα (επικοινωνίας, epp, smarty, αρχεία) |
| log.clientip | on/off | Αν σε κάθε γραμμή του log θα αναφέρεται και χωριστά η IP του χρήστη |
| log.show_credentials | on/off | Αν θα εμφανίζονται στο log τα Registrar ID, Username, Password, Γλώσσα της εντολής Login |
| log.browser | on/off | Αν θα χρησιμοποιείτε το console του browser για log. Να μην είναι ενεργό σε περιβάλλον παραγωγής. |
| log.browser_ip | IPs | Χωρίς έλεγχο ΙΡ, "IP1,IP2,..." Οι IPs που θα βλέπουν το log στον browser. Προσοχή στα double quotes και στο κόμμα. |
| log.clientip | on/off | Αν σε κάθε εγγραφή του log θα εμφανίζεται και η IP του χρήστη |
| log.show_credentials | on/off | Αν στο επίπεδο DEBUG που γράφεται το login request, θα εμφανίζεται όνομα, κωδικός της σύνδεσης στο ITE καθώς και Registrar ID με τη γλώσσα |
Προσοχή: Σε περίπτωση που έχετε λευκή οθόνη, ή άλλα σφάλματα, δείτε το activity log στο
Utilities/Logs/Activity Logτου WHMCS ή/και ανοίχτε προσωρινά την εμφάνιση σφαλμάτων από τοGeneral Settings/Other.
WHMCS Config
Πηγαίνετε Setup/Product Services/Domain Registrars, βρίσκετε το module, κάνετε Activate και στη συνέχεια Configure.
| Παράμετρος | Σχόλια |
|---|---|
| License | Ο αριθμός αδείας του module που έχετε πάρει από τη ValueHost |
| Username | Το όνομα χρήστη με το οποίο συνδέεστε στο ΙΤΕ |
| Password | Ο κωδικός με τον οποίο συνδέεστε στο ΙΤΕ (REG) |
| PasswordUAT | Ο κωδικός με τον οποίο συνδέεστε στο ΙΤΕ (UAT) - Κενό αν είναι ίδιος με το REG |
| RegID | Το 3ψήφιο ή 4ψήφιο μοναδικό ID που σας έχουν δώσει από το ΙΤΕ |
| ForceSync | Ανεξάρτητα της τιμής του DomainSync Enable ή του DomainSync Notify Only, το module θα χρησιμοποιεί τις ημέρες του SyncNextDueDate για τον συγχρονισμό των καταχωρήσεων/ανανεώσεων/μεταφορών (έκδοση 2.0.3) |
| Geo | Αν θα επιτρέπονται καταχωρήσεις domain που αποτελούν γεωγραφικό προσδιορισμό με προειδοποίηση πριν το checkout ή θα απαγορεύονται τελείως. Αυτή η λειτουργία βασίζεται σε ένα hook του WHMCS το οποίο έχει προβληματική συμπεριφορά και είναι το bug CORE-11987, οπότε μόνο η προειδοποίηση δουλεύει προς το παρόν |
| Environment | Επιλογή σε ποιό περιβάλλον θα τρέχει το module, παραγωγής ή δοκιμαστικό |
| Permission | Ποιό δικαίωμα πρέπει να έχει ένας διαχειριστής, ώστε να μπορεί να βλέπει το widget με τις μονάδες στο dashboard (πχ. Configure Domain Registrars) 1 |
| NoTransferAwayEmails | Απενεργοποίηση της αποστολής email στον διαχειριστή, σχετικά με τα αποτελέσματα του ελέγχου για domains που έχουν πάει σε άλλους καταχωρητές 2 |
| WHOIStimeout | Ορισμός timeout κατά την εκτέλεση του WHOIS σε δευτερόλεπτα (default = 3 δευτερόλεπτα) 3 |
| INI | Η τοποθεσία του greppcore.ini σε absolute path (χωρίς το filename δηλαδή) και κατά προτίμηση σε ανώτερο επίπεδο από τον root web folder |
| 1 Το module θα διαβάσει όλα τα διαθέσιμα δικαιώματα που υπάρχουν, και θα πρέπει να επιλέξετε κάποιο. Αυτό το δικαίωμα πρέπει να το έχει κάποια διαχειριστής μέσω των Administrator Roles και του ρόλου στον οποίο ανήκει. |
2 Ο έλεγχος θα γίνει ανεξάρτητα από την επιλογή αυτή. Η επιλογή αυτή αφορά μόνο την αποστολή email.
3 Το ITE εφαρμόζει πολιτική throttling όταν υπάρχουν πολλά whois queries ώστε να σας αποθαρρύνει να κάνετε πολλαπλά WHOIS queries. Αλλάζοντας αυτή την επιλογή και αυξάνοντας το χρόνο αναμαμονής κατά την εκτέλεση του WHOIS, αφήνετε το WHOIS να επιστρέψει αποτέλεσμα, αργά μεν αλλά χωρίς να βγάλει σφάλμα. Η λειτουργία αυτή χρησιμεύει μόνο όταν χρησιμοποιείτε το grwhois.php (δείτε Domains με ελληνικούς χαρακτήρες).
Προσοχή: Στο
INIβάζετε το absolute path!Aν το αρχείο είναι στο
/home/site/protected/grepp/greppcore.ini, βάζετε/home/site/protected/greppκαι όχι/home/site/protected/grepp/greppcore.ini, ούτεsite/protected/grepp.Αντίστοιχα, αν το αρχείο είναι στο
/home/site/public_html/modules/registrars/grepp/greppcore.ini, βάζετε/home/site/public_html/modules/registrars/greppκαι όχι/home/site/public_html/modules/registrars/grepp/greppcore.ini, ούτεmodules/registrars/grepp, ούτε/public_html/modules/registrars/grepp.Σε περίπτωση που έχετε λευκή οθόνη, ή άλλα σφάλματα, δείτε το activity log στο
Utilities/Logs/Activity Logτου WHMCS (https://www.site.gr/whmcs/admin/systemactivitylog.php) ή/και ανοίχτε προσωρινά την εμφάνιση σφαλμάτων από τοGeneral Settings/Other(https://www.site.gr/whmcs/admin/setup). Τα links είναι ενδεικτικά σε περίπτωση που δεν μπορείτε να δείτε σωστά το backend.
WHMCS Setup
Πηγαίνετε Setup/Product Services/Domain Pricing και ορίζετε το grepp να διαχειρίζεται τα TLDs που θέλετε καθώς και τις τιμές.
Για ελάχιστο μήκος μεταβλητού ονόματος 2 χαρακτήρες, στο whmcs/configuration.php προσθέτετε τις γραμμές:
<?php $DomainMinLengthRestrictions[".gr"] = 3; $DomainMinLengthRestrictions[".com.gr"] = 3; $DomainMinLengthRestrictions[".net.gr"] = 3; $DomainMinLengthRestrictions[".gov.gr"] = 3; $DomainMinLengthRestrictions[".edu.gr"] = 3; $DomainMinLengthRestrictions[".org.gr"] = 3; $DomainMinLengthRestrictions[".ελ"] = 3;
Templates
Ακολουθούν οι αλλαγές που θα χρειαστούν στο template six και στο αρχείο clieantareadomaincontactinfo.tpl.
Για να βγαίνει σωστά η μετάφραση του πεδίου Registrant, Admin, Billing, Tech, αλλάξτε τη γραμμή 36 από
<h4>{$contactdetail} {$LANG.supportticketscontact}</h4>
σε
<h4>{$LANG.domaincontactdetails.$contactdetail} {$LANG.supportticketscontact}</h4>
Για να βγαίνει σωστά η μετάφραση κάθε πεδίου στις επαφές, αλλάξτε τη γραμμή 69 από
<label>{$name}</label>
σε
<label>{$LANG.domaincontactdetails.$name}</label>
Για να μην μπορεί να κάνει edit ο πελάτης την επωνυμία και το contact id, στη γραμμή 70 πριν το /> tag που κλείνει η γραμμή προσθέστε το
{if $name=='Full Name' || $name=='Company Name' || $name=='ID'} readonly{/if}
Τα παραπάνω προϋποθέτουν πως έχετε βάλει και τα αντίστοιχα language files στο lang/overrides.
Είναι προφανές πως δεν μπορώ να καλύψω όλες τις πιθανές περιπτώσεις template που μπορεί να χρησιμοποιεί κάποιος, αλλά το συγκεκριμένο είναι ενδεικτικό από τις λίγες αλλαγές που πρέπει να γίνουν.
WHMCS WHOIS
Προαιρετικά, αλλά υποχρεωτικά αν θέλετε να καταχωρείτε ονόματα με ελληνικούς χαρακτήρες (ονομα.gr ή ονομα.ελ), θα πρέπει να πείτε του WHMCS να εκτελεί το WHOIS μέσω του grwhois.php.
Για περισσότερες πληροφορίες και ρυθμίσεις για τα domains με ελληνικούς χαρακτήρες δείτε την ενότητα Domains με ελληνικούς χαρακτήρες
