WP-CLI The command line interface for WordPress

WP-CLI, WordPress için komut satırı arayüzüdür. Eklenti güncellemesi, multisite kurulumların yapılandırılması ve daha birçok şeyi web tarayıcısına ihtiyaç duymadan gerçekleştirebilirsiniz.

Süregelen bakım, aşağıdakiler sayesinde:

Mevcut kararlı sürüm versiyon 2.3.0. Duyurular için @wpcli Twitter hesabını takip edebilir ya da eposta bültenine abone olabilirsiniz. Gelecek sürüm planına genel bir bakış için yol haritasına göz atın.

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

Bağlantılar: Kullanım | Kurulum | Destek | Genişletmek | Katkıda Bulunmak | Jenerik

Kullanım

WP-CLI, WordPress yönetim panelinden gerçekleştirebileceğiniz çoğu işlem için komut-satırı arabirimi sunar. Örneğin wp plugin install --activate (belge) bir WordPress eklentisini kurmanızı ve aktifleştirmenizi sağlar:

$ wp plugin install user-switching --activate
Installing User Switching (1.0.9)
Downloading installation package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating 'user-switching'...
Plugin 'user-switching' activated.
Success: Installed 1 of 1 plugins.

WP-CLI ayrıca WordPress yönetim panelinden gerçekleştiremeyeceğiniz komutları da barındırır. Örneğin, wp transient delete --all (belge) bir veya daha fazla transient’i silmenizi sağlar:

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

WP-CLI kullanımı hakkında daha detaylı bilgi için, Hızlı Giriş belgesini okuyun. Veya shell friends belgesini okuyarak yararlı komut satırı yardımcı programları hakkında bilgi edinin.

Temel şeyleri zaten biliyorum diyorsanız, direkt komutlara dalıp tema ve eklenti yönetimi, veri aktarımı, veritabanı bul-değiştir işlemi ve dahası hakkında detaylı bilgiye ulaşabilirsiniz.

Kurulum

Çoğu kullanıcı için Phar dosyasını indirerek kurmalarını öneririz. Ayrıca, ihtiyacınız olursa alternatif kurulum yöntemlerine kurulum dökümanından ulaşabilirsiniz. (Composer, Homebrew, Docker).

Lütfen WP-CLI’i kurmadan önce minimum ortam gereksinimlerin karşılandığından emin olunuz:

Gerensinimleri karşıladıktan sonra, wp-cli.phar dosyasını wget veya curl ile indirin:

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

Sonra, çalışıp çalışmadığını kontrol edin:

php wp-cli.phar --info

WP-CLI’e komut satırından wp yazarak erişebilmek için dosyayı çalıştırılabilir hale getirin ve PATH’de tanımlı olan bir yere taşıyın. Örneğin:

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

Eğer kurulum başarılı bir şekilde tamamlandıysa, wp --info komutunu çalıştırdığınızda buna benzer birşey göreceksiniz:

$ wp --info
OS:	Darwin 16.7.0 Darwin Kernel Version 16.7.0: Thu Jan 11 22:59:40 PST 2018; root:xnu-3789.73.8~1/RELEASE_X86_64 x86_64
Shell:	/bin/zsh
PHP binary:    /usr/local/bin/php
PHP version:    7.0.22
php.ini used:   /etc/local/etc/php/7.0/php.ini
WP-CLI root dir:        /home/wp-cli/.wp-cli/vendor/wp-cli/wp-cli
WP-CLI vendor dir:	    /home/wp-cli/.wp-cli/vendor
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: 2.3.0

Güncelleme

WP-CLI’i wp cli update komutu (belge) ile veya kurulum adımlarını tekrarlayarak güncelleyebilirsiniz.

Eğer WP-CLI, root veya başka bir sistem kullanıcısı tarafından sahiplenildiyse sudo wp cli update çalıştırmanız gerekecektir.

Sınırda yaşamayı seviyor musunuz? wp cli update --nightly komutu ile nightly build sürümüne güncelleyebilirsiniz. Geliştirme ortamınız için nightly build sürümler daha çok ya da az stabil olabilir ve her zaman en son ve yeni WP-CLI özelliklerini içerir.

Sekme tamamlama

WP-CLI ayrıca, Bash ve ZSH için sekme tamamlama scripti sunar. Yapmanız gereken sadece wp-completion.bash dosyasını indirmek ve kaynak olarak ~/.bash_profile dosyanıza tanımlamak:

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

Ekledikten sonra source ~/.bash_profile komutunu çalıştırmayı unutmayın.

Shell için zsh kullanıyorsanız, kaynak olarak tanımlamadan önce bashcompinit i yükleyip çalıştırmanız gerekebilir. Aşağıdaki kodları .zshrc dosyanıza ekleyin:

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

Destek

WP-CLI’nin bakımcıları ve katılımcıları genel destek soruları için sınırlı müsaitliğe sahiptir. Mevcut WP-CLI sürümu resmi olarak desteklenen tek sürümdür.

Lütfen desteğe ihtiyacınız olduğünda, öncelikle sorunuzu aşağıdaki kaynaklarda arayın:

Eğer bu kaynaklarda sorularınıza cevap bulamazsanız:

Github konuları mevcut komutlar için yenilik ve hata takibi icin kullanılmaktadır, genel destek için değildir. Hata bildirimi göndermeden önce, sorununuz zamanında ele alınması için lütfen hata bildirimi yöntemini gözden geçirin.

Lütfen Twitter üzerinden destek soruları sormayın. Twitter destek için iyi bir yer değildir, çünkü: 1) Yazışmaları 280 karakterin altında tutmak zor, ve 2) Twitter sizinle aynı soruna sahip birisinin önceki cevabı arayarak bulabileceği bir yer değil.

Unutmayın, özgür != ücretsiz; açık kaynak lisansı size özgürce kullanma ve değiştirme hakkı verir, başkalarının zamanını değil. Lütfen buna saygı duyun ve beklentilerinizi buna göre ayarlayın.

Genişletmek

Bir Komut WP-CLI’nin atomik birimidir. wp plugin install (belge) bir komuttur. wp plugin activate (belge) başka bir komuttur.

WP-CLI çağrılabilen herhangi bir sınıfı, fonksiyonu ya da anonim fonksiyonu komut olarak kaydetmeyi destekler. Kullanım detaylarını callback’in PHP dökümanından (PHPdoc) okur. WP_CLI::add_command() (belge) dahili ve üçüncü-parti komutların kaydedilmesi için kullanılmaktadır.

/**
 * 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 onlarca komutla hazır olarak gelir. Özel bir WP-CLI komutu oluşturmak görünenden daha kolaydır. Detaylar için komutlar tarif kitabına bakabilirsiniz. Dahili API dökümantasyonunu gözden geçirerek kendi WP-CLI komutunuzda kullanabileceğiniz faydalı fonksiyonları keşfedebilirsiniz.

Katkıda Bulunmak

WP-CLI’e katkıda bulunmak istediğiniz için teşekkür ederiz. WP-CLI siz ve sizin gibi topluluk üyeleri sayesinde bu kadar büyük bir proje olmayı başarabildi.

Katkıda bulunmak sadece kod yazmakla sınırlı değildir. Kendi yeteneklerinize uygun olacak şekilde; tanıtım yazıları yazarak, yerel etkinliklerde demo göstererek, başkalarının sorunlarına yardımcı olarak veya dökümantasyonumuzu gözden geçirerek katkıda bulunabilirsiniz.

Lütfen bir dakikanızı ayırıp dökümanı detaylıca okuyun. Bunları takip ederek, katkıda bulunan diğer katılımcıların ayırdığı zamana saygı gösteriniz. Buna karşılık, onlar da aynı saygıyı sizinle çalışırken göstereceklerdir (zaman farkı gözetmeksizin, dünya genelinde).

Nasıl katılacağınıza dair kapsamlı bir giriş için el kitabındaki katkı kurallarını okuyun. Bu kurallara uymak, projeye katkıda bulunan diğer üyelerin zamanına saygı duyduğunuzu bildirmenize yardımcı olur. Buna karşılık, onlar da bu saygıya karşılık vermek için ellerinden geleni zaman farkı gözetmeksizin, dünya genelinde yapacaktır.

Yönetim

WP-CLI’nın bir proje sorumlusu vardır: schlessera.

Zaman zaman, belli bir süre için yetenekli olduklarını kanıtlamış ve projeyi ileriye taşıyabilecek katılımcılara yazma izni veriyoruz.

Proje hakkında daha operasyonel ayrıntılar için el kitabındaki yönetim belgesini okuyabilirsiniz.

Jenerik

composer.json dosyasında tanımlanan kütüphanelerin yanında, aşağıdaki projeleri de kod veya fikir için kullandık: