Wordpress Setup

What Is Wordpress Setup?

Wordpress Setup is a Claude Code skill designed to streamline the process of connecting to and configuring WordPress sites through automation. This skill enables developers and technical users to establish verified connections to WordPress installations using WP-CLI over SSH or the REST API. The primary goal is to automate setup, authentication, and troubleshooting steps, ensuring a reliable workflow for content management, plugin development, or site administration, including tasks such as Elementor editing.

This skill is part of the Claude Code ecosystem and is compatible exclusively within environments that support Claude Code skills. The source code and documentation for Wordpress Setup are available on GitHub, where users can review, contribute, and integrate this skill into their development toolchain.

Why Use Wordpress Setup?

WordPress management often requires repeated tasks: configuring WP-CLI, establishing secure connections, managing authentication, and ensuring reliable access to the site’s backend. Manual setup of these components can lead to misconfiguration, access issues, or security lapses, especially across multiple sites or environments.

Wordpress Setup addresses these challenges by:

• Automating the setup of WP-CLI and SSH connections: Reducing human error and saving time.
• Verifying connections and authentication: Ensuring the environment is correctly configured before proceeding with content or code changes.
• Providing troubleshooting guidance: Assisting in resolving common connectivity or authentication problems.
• Facilitating integration with development workflows: Allowing seamless transitions from setup to further site management, deployment, or content editing.

By using Wordpress Setup, teams and individuals can standardize their connection procedures, enhance security, and improve efficiency when interacting with WordPress sites.

How to Get Started

To get started with the Wordpress Setup skill, follow these steps:

1. Install

WP-CLI

First, verify if WP-CLI is installed:

wp --version

If WP-CLI is not present, install it using the following commands:

## macOS/Linux installation
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

For remote management, ensure the SSH command package for WP-CLI is installed:

wp package install wp-cli/ssh-command

2. Establish a

Connection

You can connect to your WordPress site in two primary ways:

A. WP-CLI Over SSH (Preferred)

This method allows direct command-line access to your WordPress site’s backend:

wp --ssh=user@hostname/path/to/wordpress option get siteurl

Examples:

• Rocket.net:
  bash

  wp --ssh=user@hostname/www/sitename/public option get siteurl

• cPanel:
  bash

  wp --ssh=user@hostname/public_html option get siteurl

Test your connection with a basic command:

wp --ssh=user@host/path core version

Provide the SSH username, host, and the path to your WordPress directory as required.

B. REST API with Application Password

If SSH access is unavailable, you can use the WordPress REST API with an application password:

1. Log into your WordPress admin dashboard.
2. Navigate to Users > Profile.
3. Scroll to Application Passwords, create a new password, and save the credentials.
4. Configure your connection using these credentials to authenticate API requests.

Key Features

Wordpress Setup offers several features tailored for development and operational efficiency:

• Automated Environment Checks: Ensures WP-CLI is installed and properly configured before attempting site connections.
• Flexible Connection Methods: Supports both SSH-based WP-CLI operations and REST API authentication using application passwords.
• Connection Verification: Confirms successful authentication and access by running test commands and validating responses.
• Config Persistence: Saves working connection configurations for future use, facilitating repeatable workflows.
• Troubleshooting Assistance: Provides actionable feedback and guidance when encountering connectivity or authentication errors.
• Compatibility with Elementor and Content Tools: Ensures configurations are compatible with popular workflow tools like Elementor.

Best Practices

To maximize the benefits of the Wordpress Setup skill, consider the following best practices:

• Use SSH Where Possible: SSH-based WP-CLI access is generally more secure and offers greater control than REST API connections.
• Secure Your Credentials: Store SSH keys and application passwords securely. Avoid sharing these credentials in unsecured channels.
• Test with Simple Commands: Always verify your connection with a basic command such as core version or option get siteurl before running critical operations.
• Maintain WP-CLI Updates: Keep your WP-CLI and its extensions updated to benefit from the latest features and security patches.
• Document Connection Details: Clearly document the SSH paths and credentials for each environment (staging, production) to avoid confusion or misconfigurations.
• Regularly Review Access: Periodically review and update application passwords and SSH keys, especially when team members change.

Important Notes

• Skill Compatibility: Wordpress Setup is designed for use with Claude Code and may not function as a standalone CLI tool.
• SSH Requirements: For remote WP-CLI commands, SSH access is required. Ensure your hosting provider supports SSH and that your user has sufficient permissions.
• REST API Limitations: Using application passwords for REST API access provides limited capabilities compared to full WP-CLI access. Some operations may not be supported.
• Security Considerations: Never expose your SSH keys or application passwords in public repositories or insecure locations.
• Plugin and Theme Compatibility: Ensure that any security plugins or custom configurations on your WordPress site do not block WP-CLI or REST API access.
• Troubleshooting: If you encounter issues connecting, verify network access, correct paths, and user permissions. Refer to WP-CLI and WordPress documentation for advanced troubleshooting.

By following these guidelines and leveraging the Wordpress Setup skill, you can simplify and secure your WordPress development workflows, enabling efficient site management and automation.