Managing WordPress Installations

Operator: <wp-instance>

XML Schema: wpinstance.xsd

Plesk version: Plesk 12.0 and later

XML API version: 1.6.6.0 and later

Plesk user: Administrator, reseller, customer

Description

The wp-instance operator is used to manage WordPress installations, plugins and themes.

Supported operations

 

  • The enable-auto-updates operation switches on auto-updates on a WordPress installation.
  • The disable-auto-updates operation switches off auto-updates on a WordPress installation.
  • The remove command uninstalls WordPress from a site.
  • The update-core command updates a WordPress installation.
  • The clear-cache command checks whether updates are available for the selected WordPress installation.
  • The activate-plugin command activates the specified plugin on the specified WordPress installation.
  • The deactivate-plugin command deactivates the specified plugin on the specified WordPress installation.
  • The uninstall-plugin command removes the specified plugin from the specified WordPress installation.
  • The update-plugin command updates the specified plugin on the specified WordPress installation.
  • The install-plugin command installs the specified plugin on the specified WordPress installation.
  • The activate-theme command activates the specified theme on the specified WordPress installation.
  • The uninstall-theme command removes the specified theme from the specified WordPress installation.
  • The update-theme command updates the specified theme on the specified WordPress installation.
  • The install-theme command installs the specified theme on the specified WordPress installation.
  • The get-list command retrieves the list of all WordPress installations on a server.
  • The get-plugin-list command retrieves the list of plugins installed on a WordPress installation.
  • The get-theme-list command retrieves the list of themes installed on a WordPress installation.
  • The search-plugins command searches for installed plugins by a plugin name.
  • The search-themes command searches for installed themes by a theme name.
  • The get-security-status operation retrieves the security status of the specified WordPress installation.

 

Request Examples

Retrieving a List of WordPress Installations
<packet>
    <wp-instance>
         <get-list>
         </get-list>
     </wp-instance>
</packet>
Switching On Auto-updates on a WordPress Installation
<packet>
    <wp-instance>
         <enable-auto-updates>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
         </enable-auto-updates>
     </wp-instance>
</packet>
Switching Off Auto-updates on a WordPress Installation
<packet>
    <wp-instance>
         <disable-auto-updates>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
         </disable-auto-updates>
     </wp-instance>
</packet>
Updating WordPress Installations
<packet>
    <wp-instance>
         <update-core>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
         </update-core>
     </wp-instance>
</packet>
Uninstalling WordPress
<packet>
    <wp-instance>
         <remove-instance>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
         </remove-instance>
     </wp-instance>
</packet>
Updating Cache and Retrieving Updates Information for a WordPress Installation

Note: The information about available updates will be displayed in the Plesk GUI. It will not be available in the response packet.

<packet>
    <wp-instance>
         <clear-cache>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
         </clear-cache>
     </wp-instance>
</packet>
Retrieving the result of the last security check
<packet><br>	<wp-instance><br>		<get-security-status><br>			<filter><br>				<id>WordPress instance ID</id><br>			</filter><br>		</get-security-status><br>	</wp-instance><br></packet>
Retrieving the List of Plugins Installed on a WordPress Installation
<packet>
    <wp-instance>
         <get-plugin-list>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
         </get-plugin-list>
     </wp-instance>
</packet>
Retrieving the List of Themes Installed on a WordPress Installation
<packet>
    <wp-instance>
         <get-theme-list>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
         </get-theme-list>
     </wp-instance>
</packet>
Searching for an Installed Plugin
<packet>
    <wp-instance>
         <search-plugins>
                  <term>search query</term>
         </search-plugins>
     </wp-instance>
</packet>
Searching for an Installed Theme
<packet>
    <wp-instance>
         <search-themes>
                  <term>search query</term>
         </search-themes>
     </wp-instance>
</packet>
Installing a Plugin
<packet>
    <wp-instance>
         <install-plugin>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>plugin ID</asset-id>
         </install-plugin>
     </wp-instance>
</packet>
Updating a Plugin
<packet>
    <wp-instance>
         <update-plugin>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>plugin ID</asset-id>
         </update-plugin>
     </wp-instance>
</packet>
Activating a Plugin
<packet>
    <wp-instance>
         <activate-plugin>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>plugin ID</asset-id>
         </activate-plugin>
     </wp-instance>
</packet>
Deactivating a Plugin
<packet>
    <wp-instance>
         <deactivate-plugin>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>plugin ID</asset-id>
         </deactivate-plugin>
     </wp-instance>
</packet>
Removing a Plugin
<packet>
    <wp-instance>
         <uninstall-plugin>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>plugin ID</asset-id>
         </uninstall-plugin>
     </wp-instance>
</packet>
Installing a Theme
<packet>
    <wp-instance>
         <install-theme>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>theme ID</asset-id>
         </install-theme>
     </wp-instance>
</packet>
Updating a Theme
<packet>
    <wp-instance>
         <update-theme>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>theme ID</asset-id>
         </update-theme>
     </wp-instance>
</packet>
Activating a Theme
<packet>
    <wp-instance>
         <activate-theme>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>theme ID</asset-id>
         </activate-theme>
     </wp-instance>
</packet>
Removing a Theme
<packet>
    <wp-instance>
         <uninstall-theme>
             <filter>
                  <id>WordPress instance ID</id>
             </filter>
             <asset-id>theme ID</asset-id>
         </uninstall-theme>
     </wp-instance>
</packet>
Retrieving a Security Status of a WordPress Installation

The following packet retrieves the security status of the installation of WordPress with ID=74.

<packet>
  <wp-instance>
    <get-security-status>
      <filter>
        <id>74</id>
      </filter>
    </get-security-status>
  </wp-instance>
</packet>