أمر التمديد

wp-cli/extension-command

يدير المكونات الإضافية والموضوعات، بما في ذلك عمليات التثبيت والتنشيط والتحديثات.

روابط سريعة: استخدام | تثبيت | المساهمة | يدعم

استخدام

تنفذ هذه الحزمة الأوامر التالية:

البرنامج المساعد الفسفور الأبيض

يدير المكونات الإضافية، بما في ذلك عمليات التثبيت والتنشيط والتحديثات.

 wp plugin

راجع مورد مطور WordPress Plugin Handbook لمزيد من المعلومات حول المكونات الإضافية.

أمثلة

 # Activate plugin
$ wp plugin activate hello
Plugin 'hello' activated.
Success: Activated 1 of 1 plugins.

# Deactivate plugin
$ wp plugin deactivate hello
Plugin 'hello' deactivated.
Success: Deactivated 1 of 1 plugins.

# Delete plugin
$ wp plugin delete hello
Deleted 'hello' plugin.
Success: Deleted 1 of 1 plugins.

# Install the latest version from wordpress.org and activate
$ wp plugin install bbpress --activate
Installing bbPress (2.5.9)
Downloading install package from https://downloads.wordpress.org/plugin/bbpress.2.5.9.zip...
Using cached file '/home/vagrant/.wp-cli/cache/plugin/bbpress-2.5.9.zip'...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating 'bbpress'...
Plugin 'bbpress' activated.
Success: Installed 1 of 1 plugins.

تفعيل البرنامج المساعد wp

تنشيط واحد أو أكثر من المكونات الإضافية.

 wp plugin activate [...] [--all] [--exclude=] [--network]

خيارات

 [...]
	One or more plugins to activate.

[--all]
	If set, all plugins will be activated.

[--exclude=]
	Comma separated list of plugin slugs to be excluded from activation.

[--network]
	If set, the plugin will be activated for the entire multisite network.

أمثلة

 # Activate plugin
$ wp plugin activate hello
Plugin 'hello' activated.
Success: Activated 1 of 1 plugins.

# Activate plugin in entire multisite network
$ wp plugin activate hello --network
Plugin 'hello' network activated.
Success: Network activated 1 of 1 plugins.

# Activate plugins that were recently active.
$ wp plugin activate $(wp plugin list --recently-active --field=name)
Plugin 'bbpress' activated.
Plugin 'buddypress' activated.
Success: Activated 2 of 2 plugins.

# Activate plugins that were recently active on a multisite.
$ wp plugin activate $(wp plugin list --recently-active --field=name) --network
Plugin 'bbpress' network activated.
Plugin 'buddypress' network activated.
Success: Activated 2 of 2 plugins.

تعطيل البرنامج المساعد wp

يقوم بإلغاء تنشيط مكون إضافي واحد أو أكثر.

 wp plugin deactivate [...] [--uninstall] [--all] [--exclude=] [--network]

خيارات

 [...]
	One or more plugins to deactivate.

[--uninstall]
	Uninstall the plugin after deactivation.

[--all]
	If set, all plugins will be deactivated.

[--exclude=]
	Comma separated list of plugin slugs that should be excluded from deactivation.

[--network]
	If set, the plugin will be deactivated for the entire multisite network.

أمثلة

 # Deactivate plugin
$ wp plugin deactivate hello
Plugin 'hello' deactivated.
Success: Deactivated 1 of 1 plugins.

# Deactivate all plugins with exclusion
$ wp plugin deactivate --all --exclude=hello,wordpress-seo
Plugin 'contact-form-7' deactivated.
Plugin 'ninja-forms' deactivated.
Success: Deactivated 2 of 2 plugins.

حذف البرنامج المساعد wp

يحذف ملفات البرنامج المساعد دون إلغاء تنشيطها أو إلغاء تثبيتها.

 wp plugin delete [...] [--all] [--exclude=]

خيارات

 [...]
	One or more plugins to delete.

[--all]
	If set, all plugins will be deleted.

[--exclude=]
	Comma separated list of plugin slugs to be excluded from deletion.

أمثلة

 # Delete plugin
$ wp plugin delete hello
Deleted 'hello' plugin.
Success: Deleted 1 of 1 plugins.

# Delete inactive plugins
$ wp plugin delete $(wp plugin list --status=inactive --field=name)
Deleted 'tinymce-templates' plugin.
Success: Deleted 1 of 1 plugins.

# Delete all plugins excluding specified ones
$ wp plugin delete --all --exclude=hello-dolly,jetpack
Deleted 'akismet' plugin.
Deleted 'tinymce-templates' plugin.
Success: Deleted 2 of 2 plugins.

الحصول على البرنامج المساعد wp

يحصل على تفاصيل حول البرنامج المساعد المثبت.

 wp plugin get  [--field=] [--fields=] [--format=]

خيارات

 
	The plugin to get.

[--field=]
	Instead of returning the whole plugin, returns the value of a single field.

[--fields=]
	Limit the output to specific fields. Defaults to all fields.

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - json
	  - yaml
	---

الحقول المتاحة

سيتم عرض هذه الحقول افتراضيًا للمكون الإضافي:

• اسم
• عنوان
• مؤلف
• إصدار
• وصف
• حالة

هذه الحقول متاحة اختياريًا:

• يتطلب_wp
• يتطلب_php
• require_plugins

أمثلة

 # Get plugin details.
$ wp plugin get bbpress --format=json
{"name":"bbpress","title":"bbPress","author":"The bbPress Contributors","version":"2.6.9","description":"bbPress is forum software with a twist from the creators of WordPress.","status":"active"}

تثبيت البرنامج المساعد wp

تثبيت مكون إضافي واحد أو أكثر.

 wp plugin install ... [--version=] [--force] [--activate] [--activate-network] [--insecure]

خيارات

 ...
	One or more plugins to install. Accepts a plugin slug, the path to a local zip file, or a URL to a remote zip file.

[--version=]
	If set, get that particular version from wordpress.org, instead of the
	stable version.

[--force]
	If set, the command will overwrite any installed version of the plugin, without prompting
	for confirmation.

[--activate]
	If set, the plugin will be activated immediately after install.

[--activate-network]
	If set, the plugin will be network activated immediately after install

[--insecure]
	Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack.

أمثلة

 # Install the latest version from wordpress.org and activate
$ wp plugin install bbpress --activate
Installing bbPress (2.5.9)
Downloading install package from https://downloads.wordpress.org/plugin/bbpress.2.5.9.zip...
Using cached file '/home/vagrant/.wp-cli/cache/plugin/bbpress-2.5.9.zip'...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating 'bbpress'...
Plugin 'bbpress' activated.
Success: Installed 1 of 1 plugins.

# Install the development version from wordpress.org
$ wp plugin install bbpress --version=dev
Installing bbPress (Development Version)
Downloading install package from https://downloads.wordpress.org/plugin/bbpress.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Success: Installed 1 of 1 plugins.

# Install from a local zip file
$ wp plugin install ../my-plugin.zip
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Success: Installed 1 of 1 plugins.

# Install from a remote zip file
$ wp plugin install http://s3.amazonaws.com/bucketname/my-plugin.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef
Downloading install package from http://s3.amazonaws.com/bucketname/my-plugin.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Success: Installed 1 of 1 plugins.

# Update from a remote zip file
$ wp plugin install https://github.com/envato/wp-envato-market/archive/master.zip --force
Downloading install package from https://github.com/envato/wp-envato-market/archive/master.zip
Unpacking the package...
Installing the plugin...
Renamed Github-based project from 'wp-envato-market-master' to 'wp-envato-market'.
Plugin updated successfully
Success: Installed 1 of 1 plugins.

# Forcefully re-install all installed plugins
$ wp plugin install $(wp plugin list --field=name) --force
Installing Akismet (3.1.11)
Downloading install package from https://downloads.wordpress.org/plugin/akismet.3.1.11.zip...
Unpacking the package...
Installing the plugin...
Removing the old version of the plugin...
Plugin updated successfully
Success: Installed 1 of 1 plugins.

تم تثبيت البرنامج المساعد wp

يتحقق مما إذا تم تثبيت مكون إضافي معين.

 wp plugin is-installed 

يُرجع رمز الخروج 0 عند التثبيت، و1 عند إلغاء التثبيت.

خيارات

 
	The plugin to check.

أمثلة

 # Check whether plugin is installed; exit status 0 if installed, otherwise 1
$ wp plugin is-installed hello
$ echo $?
1

قائمة البرنامج المساعد wp

يحصل على قائمة من الإضافات.

 wp plugin list [--=] [--field=] [--fields=] [--format=] [--status=] [--skip-update-check] [--recently-active]

يعرض قائمة بالمكونات الإضافية المثبتة على الموقع مع حالة التنشيط، سواء كان هناك تحديث متاح أم لا، وما إلى ذلك.

استخدم --status=dropin لسرد Dropins المثبتة (على سبيل المثال، object-cache.php ).

خيارات

 [--=]
	Filter results based on the value of a field.

[--field=]
	Prints the value of a single field for each plugin.

[--fields=]
	Limit the output to specific object fields.

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - count
	  - json
	  - yaml
	---

[--status=]
	Filter the output by plugin status.
	---
	options:
	  - active
	  - active-network
	  - dropin
	  - inactive
	  - must-use
	---

[--skip-update-check]
	If set, the plugin update check will be skipped.

[--recently-active]
	If set, only recently active plugins will be shown and the status filter will be ignored.

الحقول المتاحة

سيتم عرض هذه الحقول افتراضيًا لكل مكون إضافي:

• اسم
• حالة
• تحديث
• إصدار
• update_version
• التحديث التلقائي

هذه الحقول متاحة اختياريًا:

• update_package
• update_id
• عنوان
• وصف
• ملف
• مؤلف
• test_up_to
• wporg_status
• wporg_last_updated

أمثلة

 # List active plugins on the site.
$ wp plugin list --status=active --format=json
[{"name":"dynamic-hostname","status":"active","update":"none","version":"0.4.2","update_version":"","auto_update":"off"},{"name":"tinymce-templates","status":"active","update":"none","version":"4.8.1","update_version":"","auto_update":"off"},{"name":"wp-multibyte-patch","status":"active","update":"none","version":"2.9","update_version":"","auto_update":"off"},{"name":"wp-total-hacks","status":"active","update":"none","version":"4.7.2","update_version":"","auto_update":"off"}]

# List plugins on each site in a network.
$ wp site list --field=url | xargs -I % wp plugin list --url=%
+---------+----------------+-----------+---------+-----------------+------------+
| name    | status         | update    | version | update_version | auto_update |
+---------+----------------+-----------+---------+----------------+-------------+
| akismet | active-network | none      | 5.3.1   |                | on          |
| hello   | inactive       | available | 1.6     | 1.7.2          | off         |
+---------+----------------+-----------+---------+----------------+-------------+
+---------+----------------+-----------+---------+----------------+-------------+
| name    | status         | update    | version | update_version | auto_update |
+---------+----------------+-----------+---------+----------------+-------------+
| akismet | active-network | none      | 5.3.1   |                | on          |
| hello   | inactive       | available | 1.6     | 1.7.2          | off         |
+---------+----------------+-----------+---------+----------------+-------------+

# Check whether plugins are still active on WordPress.org
$ wp plugin list --fields=name,wporg_status,wporg_last_updated
+--------------------+--------------+--------------------+
| name               | wporg_status | wporg_last_updated |
+--------------------+--------------+--------------------+
| akismet            | active       | 2023-12-11         |
| user-switching     | active       | 2023-11-17         |
| wordpress-importer | active       | 2023-04-28         |
| local              |              |                    |
+--------------------+--------------+--------------------+

# List recently active plugins on the site.
$ wp plugin list --recently-active --field=name --format=json
["akismet","bbpress","buddypress"]

مسار البرنامج المساعد wp

يحصل على المسار إلى البرنامج المساعد أو إلى دليل البرنامج المساعد.

 wp plugin path [] [--dir]

خيارات

 []
	The plugin to get the path to. If not set, will return the path to the
	plugins directory.

[--dir]
	If set, get the path to the closest parent directory, instead of the
	plugin file.

أمثلة

 $ cd $(wp plugin path) && pwd
/var/www/wordpress/wp-content/plugins

بحث البرنامج المساعد wp

يبحث في دليل البرنامج المساعد WordPress.org.

 wp plugin search  [--page=] [--per-page=] [--field=] [--fields=] [--format=]

يعرض المكونات الإضافية في دليل المكونات الإضافية لـ WordPress.org والتي تطابق استعلام بحث معين.

خيارات

 
	The string to search for.

[--page=]
	Optional page to display.
	---
	default: 1
	---

[--per-page=]
	Optional number of results to display.
	---
	default: 10
	---

[--field=]
	Prints the value of a single field for each plugin.

[--fields=]
	Ask for specific fields from the API. Defaults to name,slug,author_profile,rating. Acceptable values:

**name**: Plugin Name
**slug**: Plugin Slug
**version**: Current Version Number
**author**: Plugin Author
**author_profile**: Plugin Author Profile
**contributors**: Plugin Contributors
**requires**: Plugin Minimum Requirements
**tested**: Plugin Tested Up To
**compatibility**: Plugin Compatible With
**rating**: Plugin Rating in Percent and Total Number
**ratings**: Plugin Ratings for each star (1-5)
**num_ratings**: Number of Plugin Ratings
**homepage**: Plugin Author's Homepage
**description**: Plugin's Description
**short_description**: Plugin's Short Description
**sections**: Plugin Readme Sections: description, installation, FAQ, screenshots, other notes, and changelog
**downloaded**: Plugin Download Count
**last_updated**: Plugin's Last Update
**added**: Plugin's Date Added to wordpress.org Repository
**tags**: Plugin's Tags
**versions**: Plugin's Available Versions with D/L Link
**donate_link**: Plugin's Donation Link
**banners**: Plugin's Banner Image Link
**icons**: Plugin's Icon Image Link
**active_installs**: Plugin's Number of Active Installs
**contributors**: Plugin's List of Contributors
**url**: Plugin's URL on wordpress.org

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - count
	  - json
	  - yaml
	---

أمثلة

 $ wp plugin search dsgnwrks --per-page=20 --format=json
Success: Showing 3 of 3 plugins.
[{"name":"DsgnWrks Instagram Importer Debug","slug":"dsgnwrks-instagram-importer-debug","rating":0},{"name":"DsgnWrks Instagram Importer","slug":"dsgnwrks-instagram-importer","rating":84},{"name":"DsgnWrks Twitter Importer","slug":"dsgnwrks-twitter-importer","rating":80}]

$ wp plugin search dsgnwrks --fields=name,version,slug,rating,num_ratings
Success: Showing 3 of 3 plugins.
+-----------------------------------+---------+-----------------------------------+--------+-------------+
| name                              | version | slug                              | rating | num_ratings |
+-----------------------------------+---------+-----------------------------------+--------+-------------+
| DsgnWrks Instagram Importer Debug | 0.1.6   | dsgnwrks-instagram-importer-debug | 0      | 0           |
| DsgnWrks Instagram Importer       | 1.3.7   | dsgnwrks-instagram-importer       | 84     | 23          |
| DsgnWrks Twitter Importer         | 1.1.1   | dsgnwrks-twitter-importer         | 80     | 1           |
+-----------------------------------+---------+-----------------------------------+--------+-------------+

حالة البرنامج المساعد wp

يكشف عن حالة واحد أو كل المكونات الإضافية.

 wp plugin status []

خيارات

 []
	A particular plugin to show the status for.

أمثلة

 # Displays status of all plugins
$ wp plugin status
5 installed plugins:
  I akismet                3.1.11
  I easy-digital-downloads 2.5.16
  A theme-check            20160523.1
  I wen-logo-slider        2.0.3
  M ns-pack                1.0.0
Legend: I = Inactive, A = Active, M = Must Use

# Displays status of a plugin
$ wp plugin status theme-check
Plugin theme-check details:
    Name: Theme Check
    Status: Active
    Version: 20160523.1
    Author: Otto42, pross
    Description: A simple and easy way to test your theme for all the latest WordPress standards and practices. A great theme development tool!

تبديل البرنامج المساعد wp

تبديل حالة تفعيل البرنامج المساعد.

 wp plugin toggle ... [--network]

إذا كان البرنامج المساعد نشطا، فسيتم إلغاء تنشيطه. إذا كان البرنامج المساعد غير نشط، فسيتم تفعيله.

خيارات

 ...
	One or more plugins to toggle.

[--network]
	If set, the plugin will be toggled for the entire multisite network.

أمثلة

 # Akismet is currently activated
$ wp plugin toggle akismet
Plugin 'akismet' deactivated.
Success: Toggled 1 of 1 plugins.

# Akismet is currently deactivated
$ wp plugin toggle akismet
Plugin 'akismet' activated.
Success: Toggled 1 of 1 plugins.

إلغاء تثبيت البرنامج المساعد wp

إلغاء تثبيت مكون إضافي واحد أو أكثر.

 wp plugin uninstall [...] [--deactivate] [--skip-delete] [--all] [--exclude=]

خيارات

 [...]
	One or more plugins to uninstall.

[--deactivate]
	Deactivate the plugin before uninstalling. Default behavior is to warn and skip if the plugin is active.

[--skip-delete]
	If set, the plugin files will not be deleted. Only the uninstall procedure
	will be run.

[--all]
	If set, all plugins will be uninstalled.

[--exclude=]
	Comma separated list of plugin slugs to be excluded from uninstall.

أمثلة

 $ wp plugin uninstall hello
Uninstalled and deleted 'hello' plugin.
Success: Uninstalled 1 of 1 plugins.

# Uninstall all plugins excluding specified ones
$ wp plugin uninstall --all --exclude=hello-dolly,jetpack
Uninstalled and deleted 'akismet' plugin.
Uninstalled and deleted 'tinymce-templates' plugin.
Success: Uninstalled 2 of 2 plugins.

تحديث البرنامج المساعد wp

تحديث واحد أو أكثر من المكونات الإضافية.

 wp plugin update [...] [--all] [--exclude=] [--minor] [--patch] [--format=] [--version=] [--dry-run] [--insecure]

خيارات

 [...]
	One or more plugins to update.

[--all]
	If set, all plugins that have updates will be updated.

[--exclude=]
	Comma separated list of plugin names that should be excluded from updating.

[--minor]
	Only perform updates for minor releases (e.g. from 1.3 to 1.4 instead of 2.0)

[--patch]
	Only perform updates for patch releases (e.g. from 1.3 to 1.3.3 instead of 1.4)

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - json
	  - summary
	---

[--version=]
	If set, the plugin will be updated to the specified version.

[--dry-run]
	Preview which plugins would be updated.

[--insecure]
	Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack.

أمثلة

 $ wp plugin update bbpress --version=dev
Installing bbPress (Development Version)
Downloading install package from https://downloads.wordpress.org/plugin/bbpress.zip...
Unpacking the package...
Installing the plugin...
Removing the old version of the plugin...
Plugin updated successfully.
Success: Updated 1 of 2 plugins.

$ wp plugin update --all
Enabling Maintenance mode...
Downloading update from https://downloads.wordpress.org/plugin/akismet.3.1.11.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the plugin...
Plugin updated successfully.
Downloading update from https://downloads.wordpress.org/plugin/nginx-champuru.3.2.0.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the plugin...
Plugin updated successfully.
Disabling Maintenance mode...
+------------------------+-------------+-------------+---------+
| name                   | old_version | new_version | status  |
+------------------------+-------------+-------------+---------+
| akismet                | 3.1.3       | 3.1.11      | Updated |
| nginx-cache-controller | 3.1.1       | 3.2.0       | Updated |
+------------------------+-------------+-------------+---------+
Success: Updated 2 of 2 plugins.

$ wp plugin update --all --exclude=akismet
Enabling Maintenance mode...
Downloading update from https://downloads.wordpress.org/plugin/nginx-champuru.3.2.0.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the plugin...
Plugin updated successfully.
Disabling Maintenance mode...
+------------------------+-------------+-------------+---------+
| name                   | old_version | new_version | status  |
+------------------------+-------------+-------------+---------+
| nginx-cache-controller | 3.1.1       | 3.2.0       | Updated |
+------------------------+-------------+-------------+---------+

موضوع الفسفور الأبيض

يدير السمات، بما في ذلك عمليات التثبيت والتنشيط والتحديثات.

 wp theme

راجع مورد مطور WordPress Theme Handbook لمزيد من المعلومات حول السمات.

أمثلة

 # Install the latest version of a theme from wordpress.org and activate
$ wp theme install twentysixteen --activate
Installing Twenty Sixteen (1.2)
Downloading install package from http://downloads.wordpress.org/theme/twentysixteen.1.2.zip...
Unpacking the package...
Installing the theme...
Theme installed successfully.
Activating 'twentysixteen'...
Success: Switched to 'Twenty Sixteen' theme.
Success: Installed 1 of 1 themes.

# Get details of an installed theme
$ wp theme get twentysixteen --fields=name,title,version
+---------+----------------+
| Field   | Value          |
+---------+----------------+
| name    | Twenty Sixteen |
| title   | Twenty Sixteen |
| version | 1.2            |
+---------+----------------+

# Get status of theme
$ wp theme status twentysixteen
Theme twentysixteen details:
     Name: Twenty Sixteen
     Status: Active
     Version: 1.2
     Author: the WordPress team

تفعيل موضوع wp

تفعيل موضوع.

 wp theme activate 

خيارات

 
	The theme to activate.

أمثلة

 $ wp theme activate twentysixteen
Success: Switched to 'Twenty Sixteen' theme.

حذف موضوع wp

حذف موضوع واحد أو أكثر.

 wp theme delete [...] [--all] [--force]

يزيل السمة أو السمات من نظام الملفات.

خيارات

 [...]
	One or more themes to delete.

[--all]
	If set, all themes will be deleted except active theme.

[--force]
	To delete active theme use this.

أمثلة

 $ wp theme delete twentytwelve
Deleted 'twentytwelve' theme.
Success: Deleted 1 of 1 themes.

تعطيل موضوع wp

تعطيل السمة عند تثبيت WordPress متعدد المواقع.

 wp theme disable  [--network]

يزيل القدرة على تنشيط السمة من لوحة معلومات الموقع على تثبيت WordPress متعدد المواقع.

خيارات

 
	The theme to disable.

[--network]
	If set, the theme is disabled on the network level. Note that
	individual sites may still have this theme enabled if it was
	enabled for them independently.

أمثلة

 # Disable theme
$ wp theme disable twentysixteen
Success: Disabled the 'Twenty Sixteen' theme.

# Disable theme in network level
$ wp theme disable twentysixteen --network
Success: Network disabled the 'Twenty Sixteen' theme.

تمكين موضوع wp

تمكين السمة عند تثبيت WordPress متعدد المواقع.

 wp theme enable  [--network] [--activate]

يسمح بتنشيط السمة من لوحة التحكم الخاصة بالموقع على تثبيت WordPress متعدد المواقع.

خيارات

 
	The theme to enable.

[--network]
	If set, the theme is enabled for the entire network

[--activate]
	If set, the theme is activated for the current site. Note that
	the "network" flag has no influence on this.

أمثلة

 # Enable theme
$ wp theme enable twentysixteen
Success: Enabled the 'Twenty Sixteen' theme.

# Network enable theme
$ wp theme enable twentysixteen --network
Success: Network enabled the 'Twenty Sixteen' theme.

# Network enable and activate theme for current site
$ wp theme enable twentysixteen --activate
Success: Enabled the 'Twenty Sixteen' theme.
Success: Switched to 'Twenty Sixteen' theme.

الحصول على موضوع wp

يحصل على تفاصيل حول موضوع ما.

 wp theme get  [--field=] [--fields=] [--format=]

خيارات

 
	The theme to get.

[--field=]
	Instead of returning the whole theme, returns the value of a single field.

[--fields=]
	Limit the output to specific fields. Defaults to all fields.

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - json
	  - yaml
	---

أمثلة

 $ wp theme get twentysixteen --fields=name,title,version
+---------+----------------+
| Field   | Value          |
+---------+----------------+
| name    | Twenty Sixteen |
| title   | Twenty Sixteen |
| version | 1.2            |
+---------+----------------+

تثبيت موضوع wp

تثبيت موضوع واحد أو أكثر.

 wp theme install ... [--version=] [--force] [--activate] [--insecure]

خيارات

 ...
	One or more themes to install. Accepts a theme slug, the path to a local zip file, or a URL to a remote zip file.

[--version=]
	If set, get that particular version from wordpress.org, instead of the
	stable version.

[--force]
	If set, the command will overwrite any installed version of the theme, without prompting
	for confirmation.

[--activate]
	If set, the theme will be activated immediately after install.

[--insecure]
	Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack.

أمثلة

 # Install the latest version from wordpress.org and activate
$ wp theme install twentysixteen --activate
Installing Twenty Sixteen (1.2)
Downloading install package from http://downloads.wordpress.org/theme/twentysixteen.1.2.zip...
Unpacking the package...
Installing the theme...
Theme installed successfully.
Activating 'twentysixteen'...
Success: Switched to 'Twenty Sixteen' theme.
Success: Installed 1 of 1 themes.

# Install from a local zip file
$ wp theme install ../my-theme.zip

# Install from a remote zip file
$ wp theme install http://s3.amazonaws.com/bucketname/my-theme.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef

تم تثبيت سمة wp

يتحقق مما إذا تم تثبيت سمة معينة.

 wp theme is-installed 

يُرجع رمز الخروج 0 عند التثبيت، و1 عند إلغاء التثبيت.

خيارات

 
	The theme to check.

أمثلة

 # Check whether theme is installed; exit status 0 if installed, otherwise 1
$ wp theme is-installed hello
$ echo $?
1

قائمة سمات wp

يحصل على قائمة المواضيع.

 wp theme list [--=] [--field=] [--fields=] [--format=] [--status=] [--skip-update-check]

خيارات

 [--=]
	Filter results based on the value of a field.

[--field=]
	Prints the value of a single field for each theme.

[--fields=]
	Limit the output to specific object fields.

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - json
	  - count
	  - yaml
	---

[--status=]
	Filter the output by theme status.
	---
	options:
	  - active
	  - parent
	  - inactive
	---

[--skip-update-check]
	If set, the theme update check will be skipped.

الحقول المتاحة

سيتم عرض هذه الحقول افتراضيًا لكل موضوع:

• اسم
• حالة
• تحديث
• إصدار
• update_version
• التحديث التلقائي

هذه الحقول متاحة اختياريًا:

• update_package
• update_id
• عنوان
• وصف

أمثلة

 # List inactive themes.
$ wp theme list --status=inactive --format=csv
name,status,update,version,update_version,auto_update
twentyfourteen,inactive,none,3.8,,off
twentysixteen,inactive,available,3.0,3.1,off

تعديل موضوع wp

يقوم بتعيين تعديلات السمة والحصول عليها وإزالتها.

 wp theme mod

أمثلة

 # Set the 'background_color' theme mod to '000000'.
$ wp theme mod set background_color 000000
Success: Theme mod background_color set to 000000.

# Get single theme mod in JSON format.
$ wp theme mod get background_color --format=json
[{"key":"background_color","value":"dd3333"}]

# Remove all theme mods.
$ wp theme mod remove --all
Success: Theme mods removed.

الحصول على تعديل موضوع wp

يحصل على تعديل موضوع واحد أو أكثر.

 wp theme mod get [...] [--field=] [--all] [--format=]

خيارات

 [...]
	One or more mods to get.

[--field=]
	Returns the value of a single field.

[--all]
	List all theme mods

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - json
	  - csv
	  - yaml
	---

أمثلة

 # Get all theme mods.
$ wp theme mod get --all
+------------------+---------+
| key              | value   |
+------------------+---------+
| background_color | dd3333  |
| link_color       | #dd9933 |
| main_text_color  | #8224e3 |
+------------------+---------+

# Get single theme mod in JSON format.
$ wp theme mod get background_color --format=json
[{"key":"background_color","value":"dd3333"}]

# Get value of a single theme mod.
$ wp theme mod get background_color --field=value
dd3333

# Get multiple theme mods.
$ wp theme mod get background_color header_textcolor
+------------------+--------+
| key              | value  |
+------------------+--------+
| background_color | dd3333 |
| header_textcolor |        |
+------------------+--------+

مجموعة تعديل موضوع wp

يضبط قيمة تعديل السمة.

 wp theme mod set  

خيارات

 
	The name of the theme mod to set or update.


	The new value.

أمثلة

 # Set theme mod
$ wp theme mod set background_color 000000
Success: Theme mod background_color set to 000000.

إزالة تعديل موضوع wp

يزيل تعديلًا واحدًا أو أكثر للموضوع.

 wp theme mod remove [...] [--all]

خيارات

 [...]
	One or more mods to remove.

[--all]
	Remove all theme mods.

أمثلة

 # Remove all theme mods.
$ wp theme mod remove --all
Success: Theme mods removed.

# Remove single theme mod.
$ wp theme mod remove background_color
Success: 1 mod removed.

# Remove multiple theme mods.
$ wp theme mod remove background_color header_textcolor
Success: 2 mods removed.

مسار موضوع wp

يحصل على المسار إلى السمة أو إلى دليل السمة.

 wp theme path [] [--dir]

خيارات

 []
	The theme to get the path to. Path includes "style.css" file.
	If not set, will return the path to the themes directory.

[--dir]
	If set, get the path to the closest parent directory, instead of the
	theme's "style.css" file.

أمثلة

 # Get theme path
$ wp theme path
/var/www/example.com/public_html/wp-content/themes

# Change directory to theme path
$ cd $(wp theme path)

بحث موضوع wp

يبحث في دليل موضوع WordPress.org.

 wp theme search  [--page=] [--per-page=] [--field=] [--fields=] [--format=]

يعرض السمات الموجودة في دليل سمات WordPress.org التي تطابق استعلام بحث معين.

خيارات

 
	The string to search for.

[--page=]
	Optional page to display.
	---
	default: 1
	---

[--per-page=]
	Optional number of results to display. Defaults to 10.

[--field=]
	Prints the value of a single field for each theme.

[--fields=]
	Ask for specific fields from the API. Defaults to name,slug,author,rating. Acceptable values:

**name**: Theme Name
**slug**: Theme Slug
**version**: Current Version Number
**author**: Theme Author
**preview_url**: Theme Preview URL
**screenshot_url**: Theme Screenshot URL
**rating**: Theme Rating
**num_ratings**: Number of Theme Ratings
**homepage**: Theme Author's Homepage
**description**: Theme Description
**url**: Theme's URL on wordpress.org

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - json
	  - count
	  - yaml
	---

أمثلة

 $ wp theme search photo --per-page=6
Success: Showing 6 of 203 themes.
+----------------------+----------------------+--------+
| name                 | slug                 | rating |
+----------------------+----------------------+--------+
| Photos               | photos               | 100    |
| Infinite Photography | infinite-photography | 100    |
| PhotoBook            | photobook            | 100    |
| BG Photo Frame       | bg-photo-frame       | 0      |
| fPhotography         | fphotography         | 0      |
| Photo Perfect        | photo-perfect        | 98     |
+----------------------+----------------------+--------+

حالة موضوع wp

يكشف عن حالة موضوع واحد أو جميع المواضيع.

 wp theme status []

خيارات

 []
	A particular theme to show the status for.

أمثلة

 $ wp theme status twentysixteen
Theme twentysixteen details:
     Name: Twenty Sixteen
     Status: Inactive
     Version: 1.2
     Author: the WordPress team

تحديث موضوع wp

تحديث موضوع واحد أو أكثر.

 wp theme update [...] [--all] [--exclude=] [--minor] [--patch] [--format=] [--version=] [--dry-run] [--insecure]

خيارات

 [...]
	One or more themes to update.

[--all]
	If set, all themes that have updates will be updated.

[--exclude=]
	Comma separated list of theme names that should be excluded from updating.

[--minor]
	Only perform updates for minor releases (e.g. from 1.3 to 1.4 instead of 2.0)

[--patch]
	Only perform updates for patch releases (e.g. from 1.3 to 1.3.3 instead of 1.4)

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - json
	  - summary
	---

[--version=]
	If set, the theme will be updated to the specified version.

[--dry-run]
	Preview which themes would be updated.

[--insecure]
	Retry downloads without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack.

أمثلة

 # Update multiple themes
$ wp theme update twentyfifteen twentysixteen
Downloading update from https://downloads.wordpress.org/theme/twentyfifteen.1.5.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the theme...
Theme updated successfully.
Downloading update from https://downloads.wordpress.org/theme/twentysixteen.1.2.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the theme...
Theme updated successfully.
+---------------+-------------+-------------+---------+
| name          | old_version | new_version | status  |
+---------------+-------------+-------------+---------+
| twentyfifteen | 1.4         | 1.5         | Updated |
| twentysixteen | 1.1         | 1.2         | Updated |
+---------------+-------------+-------------+---------+
Success: Updated 2 of 2 themes.

# Exclude themes updates when bulk updating the themes
$ wp theme update --all --exclude=twentyfifteen
Downloading update from https://downloads.wordpress.org/theme/astra.1.0.5.1.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the theme...
Theme updated successfully.
Downloading update from https://downloads.wordpress.org/theme/twentyseventeen.1.2.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the theme...
Theme updated successfully.
+-----------------+----------+---------+----------------+
| name            | status   | version | update_version |
+-----------------+----------+---------+----------------+
| astra           | inactive | 1.0.1   | 1.0.5.1        |
| twentyseventeen | inactive | 1.1     | 1.2            |
+-----------------+----------+---------+----------------+
Success: Updated 2 of 2 themes.

# Update all themes
$ wp theme update --all

قائمة تعديل موضوع wp

يحصل على قائمة تعديل الموضوع.

 wp theme mod list [--field=] [--format=]

خيارات

 [--field=]
	Returns the value of a single field.

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - json
	  - csv
	  - yaml
	---

أمثلة

 # Gets a list of theme mods.
$ wp theme mod list
+------------------+---------+
| key              | value   |
+------------------+---------+
| background_color | dd3333  |
| link_color       | #dd9933 |
| main_text_color  | #8224e3 |
+------------------+---------+

التثبيت

تم تضمين هذه الحزمة مع WP-CLI نفسها، ولا يلزم أي تثبيت إضافي.

لتثبيت أحدث إصدار من هذه الحزمة فوق ما تم تضمينه في WP-CLI، قم بتشغيل:

 wp package install [email protected]:wp-cli/extension-command.git

المساهمة

نحن نقدر لك أخذ زمام المبادرة للمساهمة في هذا المشروع.

لا تقتصر المساهمة على التعليمات البرمجية فقط. نحن نشجعك على المساهمة بالطريقة التي تناسب قدراتك، من خلال كتابة البرامج التعليمية، أو تقديم عرض توضيحي في اجتماعك المحلي، أو مساعدة المستخدمين الآخرين في الإجابة على أسئلة الدعم الخاصة بهم، أو مراجعة وثائقنا.

للحصول على مقدمة أكثر شمولاً، راجع دليل WP-CLI للمساهمة. تتبع هذه الحزمة تلك السياسات والإرشادات.

الإبلاغ عن خطأ

هل تعتقد أنك وجدت خطأ؟ نحن نحب أن تساعدنا في إصلاحه.

قبل إنشاء مشكلة جديدة، يجب عليك البحث عن المشكلات الموجودة لمعرفة ما إذا كان هناك حل موجود لها، أو إذا تم إصلاحها بالفعل في إصدار أحدث.

بعد إجراء القليل من البحث واكتشاف عدم وجود مشكلة مفتوحة أو ثابتة لخللك، يرجى إنشاء مشكلة جديدة. قم بتضمين أكبر قدر ممكن من التفاصيل، وخطوات واضحة لإعادة إنتاجها إن أمكن. لمزيد من الإرشادات، راجع وثائق تقرير الأخطاء لدينا.

إنشاء طلب سحب

هل تريد المساهمة بميزة جديدة؟ الرجاء أولاً فتح مشكلة جديدة لمناقشة ما إذا كانت الميزة مناسبة للمشروع أم لا.

بمجرد أن تقرر تخصيص الوقت الكافي لرؤية طلب السحب الخاص بك، يرجى اتباع إرشاداتنا لإنشاء طلب سحب للتأكد من أنها تجربة ممتعة. راجع "الإعداد" للحصول على تفاصيل خاصة بالعمل على هذه الحزمة محليًا.

يدعم

لا تتعلق مشكلات GitHub بأسئلة الدعم العامة، ولكن هناك أماكن أخرى يمكنك تجربتها: https://wp-cli.org/#support

يتم إنشاء ملف README.md هذا ديناميكيًا من قاعدة بيانات المشروع باستخدام wp scaffold package-readme (doc). لاقتراح تغييرات، يرجى إرسال طلب سحب مقابل الجزء المقابل من قاعدة التعليمات البرمجية.