WP-CLI The command line interface for WordPress

Το WP-CLI είναι ένα σύνολο από εργαλεία γραμμής εντολών για τη διαχείριση εγκαταστάσεων WordPress. Μπορείτε να ενημερώνετε πρόσθετα, να ρυθμίζετε εγκαταστάσεις πολλαπλών ιστοτόπων και πολλά περισσότερα, χωρίς τη χρήση περιηγητή.

Για να μένετε ενημερωμένοι, ακολουθήστε το @wpcli στο Twitter ή εγγραφείτε για το ενημερωτικό μας δελτίο.

Build Status Average time to resolve an issue Percentage of issues still open

Γρήγοροι σύνδεσμοι: Χρήση | Εγκατάσταση | Υποστήριξη | Επέκταση | Συνεισφορά | Ευχαριστίες

Χρήση

Ο σκοπός του WP-CLI είναι η παροχή μίας διεπαφής γραμμής εντολών για κάθε ενέργεια που μπορεί να θέλετε να εκτελέσετε στο διαχειριστικό περιβάλλον του WordPress. Για παράδειγμα, η εντολή wp plugin install --activate (τεκμηρίωση) σας επιτρέπει να εγκαταστήσετε και να ενεργοποιήσετε ένα πρόσθετο WordPress:

$ wp plugin install rest-api --activate
Installing WordPress REST API (Version 2) (2.0-beta13)
Downloading install package from https://downloads.wordpress.org/plugin/rest-api.2.0-beta13.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating 'rest-api'...
Success: Plugin 'rest-api' activated.

Το WP-CLI περιλαμβάνει επίσης εντολές για πολλά πράγματα που δεν μπορείτε να κάνετε στο διαχειριστικό περιβάλλον του WordPress. Για παράδειγμα, η εντολή wp transient delete-all (τεκμηρίωση) σας επιτρέπει να διαγράψετε ένα ή όλα τα transients:

$ wp transient delete-all
Success: 34 transients deleted from the database.

Για μία πιο ολοκληρωμένη εισαγωγή στη χρήση του WP-CLI, διαβάστε τον οδηγό γρήγορης εκκίνησης.

Αισθάνεστε ήδη άνετα με τα βασικά; Προχωρήστε στην πλήρη λίστα εντολών για λεπτομερείς πληροφορίες για το πως να διαχειρίζεστε τα θέματα και τα πρόσθετα, να εισάγετε και να εξάγετε δεδομένα, να εκτελείτε λειτουργίες εύρεσης-αντικατάστασης στη βάση δεδομένων και πολλά περισσότερα.

Εγκατάσταση

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

Πριν την εγκατάσταση του WP-CLI, παρακαλούμε βεβαιωθείτε ότι το περιβάλλον σας ανταποκρίνεται στις ελάχιστες απαιτήσεις:

Μόλις επιβεβαιώσετε τις απαιτήσεις, μεταφορτώστε το αρχείο wp-cli.phar χρησιμοποιώντας την εντολή wget ή curl:

$ curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Μετά, ελέγξτε ότι δουλεύει:

$ php wp-cli.phar --info

Για να χρησιμοποιήσετε το WP-CLI από τη γραμμή εντολών πληκτρολογώντας wp, κάντε το αρχείο εκτελέσιμο και μετακινήστε το κάπου μέσα στο PATH σας. Για παράδειγμα:

$ chmod +x wp-cli.phar
$ sudo mv wp-cli.phar /usr/local/bin/wp

Αν το WP-CLI έχει εγκατασταθεί επιτυχώς, όταν εκτελέσετε wp --info θα πρέπει να δείτε κάτι σαν αυτό:

$ wp --info
PHP binary:    /usr/bin/php5
PHP version:    5.5.9-1ubuntu4.14
php.ini used:   /etc/php5/cli/php.ini
WP-CLI root dir:        /home/wp-cli/.wp-cli
WP-CLI packages dir:    /home/wp-cli/.wp-cli/packages/
WP-CLI global config:   /home/wp-cli/.wp-cli/config.yml
WP-CLI project config:
WP-CLI version: 0.25.0

Ενημέρωση

Μπορείτε να ενημερώσετε το WP-CLI με την εντολή wp cli update (τεκμηρίωση), ή επαναλαμβάνοντας τα βήματα εγκατάστασης.

Θέλετε να ζείτε τη ζωή στα άκρα; Εκτελέστε wp cli update --nightly για να χρησιμοποιήσετε την τελευταία nightly build WP-CLI. Το nightly build είναι αρκετά ασφαλές για να χρησιμοποιηθεί σε δοκιμαστικό περιβάλλον, και πάντα περιλαμβάνει τα τελευταία και καλύτερα χαρακτηριστικά του WP-CLI.

Συμπληρώσεις Tab

Το WP-CLI έρχεται επίσης με ένα αρχείο για συμπλήρωση tab για το Bash και το ZSH. Απλά μεταφορτώστε το wp-completion.bash και προσθέστε την παρακάτω γραμμή στο αρχείο ~/.bash_profile:

source /FULL/PATH/TO/wp-completion.bash

Μην ξεχάσετε να εκτελέσετε την εντολή source ~/.bash_profile μετά.

Αν χρησιμοποιείτε zsh για κέλυφος, ίσως χρειαστεί να φορτώσετε και να εκκινήσετε το bashcompinit πριν το source. Τοποθετείστε το παρακάτων στο στο αρχείο σας .zshrc:

autoload bashcompinit
bashcompinit
source /FULL/PATH/TO/wp-completion.bash

Υποστήριξη

Τα άτομα που συντηρούν το WP-CLI και συνεισφέρουν σε αυτό, κάνουν ότι καλύτερο μπορούν για να απαντάνε σε όλα τα νέα θέματα εγκαίρως. Για να κάνετε τη βέλτιστη χρήση του εθελοντικού τους χρόνου, παρακαλώ δείτε πρώτα μήπως υπάρχει απάντηση στην ερώτησή σας σε έναν από τους ακόλουθους συνδέσμους:

Αν δε μπορείτε να βρείτε απάντηση σε ένα από τις υπάρχουσες πηγές, δημιουργήστε ένα θέμα με την ερώτησή σας.

Παρακαλώ μη ζητάτε υποστήριξη στο Twitter. Το Twitter δεν είναι αποδεκτός χώρος για υποστήριξη επειδή: 1) είναι δύσκολο να διατηρήσεις συζητήσεις σε κάτω από 140 χαρακτήρες, και 2) το Twitter δεν είναι ένας χώρος όπου κάποιος με την ίδια ερώτηση με εσάς μπορεί να ψάξει για απάντηση σε προηγούμενη συζήτηση.

Αν έχετε λογαριασμό στο WordPress.org, μπορείτε επίσης να συμμετέχετε στο κανάλι #cli του WordPress.org Slack.

Επέκταση

Μία εντολή είναι μια ατομική μονάδα λειτουργικότητας του WP-CLI. Η wp plugin install (τεκμηρίωση) είναι μία εντολή. Η wp plugin activate (τεκμηρίωση) είναι μία άλλη.

Το WP-CLI υποστηρίζει την καταχώρηση σαν μία εντολή κάθε κλάσης ή συνάρτησης που μπορεί να καλεστεί. Διαβάζει λεπτομέρειες χρήσης από το PHPdoc. Το WP_CLI::add_command() (τεκμηρίωση) χρησιμοποιείται για εσωτερική καταχώρηση εντολής και καταχώρηση από τρίτους.

/**
 * Delete an option from the database.
 *
 * Returns an error if the option didn't exist.
 *
 * ## OPTIONS
 *
 * <key>
 * : Key for the option.
 *
 * ## EXAMPLES
 *
 *     $ wp option delete my_option
 *     Success: Deleted 'my_option' option.
 */
$delete_option_cmd = function( $args ) {
	list( $key ) = $args;

	if ( ! delete_option( $key ) ) {
		WP_CLI::error( "Could not delete '$key' option. Does it exist?" );
	} else {
		WP_CLI::success( "Deleted '$key' option." );
	}
};
WP_CLI::add_command( 'option delete', $delete_option_cmd );

Το WP-CLI έρχεται με ένα πλήθος από εντολές. Είναι πιο εύκολο απ’ότι φαίνεται να δημιουργήσετε μια εντολή WP-CLI. Διαβάστε το εγχειρίδιο εντολών για να μάθετε περισσότερα. Πλοηγηθείτε στην τεκμηρίωση εσωτερικού API για να ανακαλύψετε μια ποικιλία από χρήσιμες συναρτήσεις που μπορείτε να χρησιμοποιήσετε στη δική σας WP-CLI εντολή.

Συνεισφορά

Καλώς ήρθατε και ευχαριστούμε!

Εκτιμούμε που παίρνετε την πρωτοβουλία να συνεισφέρετε στο WP-CLI. Οφείλετε σας εσάς και στην κοινότητα γύρω σας το γεγονός ότι το WP-CLI είναι ένα τόσο ωραίο έργο.

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

Παρακαλούμε αφιερώστε λίγο χρόνο για να διαβάσετε αυτές τις κατευθηντήριες γραμμές σε βάθος. Ακολουθώντας τις, βοηθάει να επικοινωνηθεί ότι σέβεστε το χρόνο των άλλων ατόμων που συνεισφέρουν στο έργο. Με τη σειρά τους, αυτοί θα κάνουν ότι καλύτερο να ανταποδώσουν αυτόν το σεβασμό όταν θα δουλεύουν μαζί σας, σε διάφες ζώνες ώρας και από όλο τον κόσμο.

Ομάδα

Η βασική ομάδα του WP-CLI αποτελείται από τα ακόλουθα άτομα:

Διαβάστε περισσότερα σχετικά με τη διακυβέρνηση του έργου και δείτε την πλήρη λίστα με τα άτομα που έχουν συνεισφέρει.

Ευχαριστίες

Εκτός τις βιβλιοθήκες που ορίζονται στο composer.json, έχουμε χρησιμοποιήσει κώδικα ή ιδέες από τα ακόλουθα έργα: