Introduction

In order for WordPatch to read and write files to your web server, first-time users will be required to configure their filesystem settings. Follow the instructions below to either configure or reconfigure your WordPatch filesystem settings.


Navigating to the Filesystem Configuration Wizard

Head to the WordPatch settings page and scroll to the bottom of the page to find the Configure Filesystem button. If this is not your first time configuring the filesystem settings, the button will instead be labeled Re-configure Filesystem.


Filesystem Configuration Settings

Once presented with the Filesystem Configuration Wizard, use the inputs on the page to specify access settings for reading and writing files. In most cases, WordPatch is able to determine the majority of the settings automatically from the run-time environment. However, in some cases (i.e., FTP/SSH password) the user will need to manually input this information to protect your website’s security. In other cases, you may want to change the values automatically predetermined by WordPatch to better suit your needs regardless of what they may be.


During the filesystem configuration process, you will be required to go through one or more steps. Simply click Next when you are ready to go to the next page.


Basic Filesystem Settings

Filesystem Method

WordPatch can read and write from your filesystem in a number of ways. The options are:

  • Direct Filesystem Access: This method uses PHP directly to read and write from the filesystem. This is the easiest and recommended method.

  • SSH: This method uses SSH to read and write from the filesystem.

  • FTP (via extension): This method uses the FTP PHP extension to read and write from the filesystem.

  • FTP (via sockets): This method uses FTP via PHP’s socket functions to read and write from the filesystem.


Filesystem Timeout

Timeout value (in seconds) for filesystem related functions within WordPatch. This applies to operations and connections alike.

The default and recommended value is: 30


Filesystem CHMOD File

CHMOD value (in octal) to be used for files that are written to your filesystem.

The default and recommended value is: 0644


Filesystem CHMOD Directory

CHMOD value (in octal) to be used for directories that are written to your filesystem.

The default and recommended value is: 0755


FTP Filesystem Settings

FTP Host

The FTP host is the hostname or IP address that should be used to connect to the FTP server. Make sure to include the port number. (i.e., yourftphost.com:21)


FTP Username

The FTP username is the username to be used when connecting to the FTP server.


FTP Password

The FTP password is the password to be used when connecting to the FTP server.


FTP SSL

The FTP SSL allows you to specify whether or not to use SSL when connecting to the FTP server.


FTP WordPress Root Path

The FTP WordPress Root Path allows you to specify the path to your WordPress installation relative to the FTP user’s root directory.


FTP WordPress Content Path

The FTP WordPress Content Path allows you to specify the path to your WordPress installation’s content directory (ie: wp-content) relative to the FTP user’s root directory.


FTP WordPress Plugins Path

The FTP WordPress Content Path allows you to specify the path to your WordOress installation’s plugin directory (ie: wp-content/plugins) relative to the FTP user’s root directory.


SSH Filesystem Settings

SSH Host

The SSH host is the hostname or IP address that should be used to connect to the SSH server. Make sure to include the port number. (i.e., yoursshhost.com:22)


SSH Username

The SSH username is the username to be used when connecting to the SSH server.


SSH Password / Passphrase

The SSH password is the password to be used when connecting to the SSH server. However, if you are using a private/public key pair, you may specify the key’s passphrase instead.


SSH Public Key

The SSH public key is the path of the public key (if any) to be used when connecting to the SSH server. The path should be specified relative to the SSH user’s root directory.


SSH Private Key

The SSH private key is the path of the private key (if any) to be used when connecting to the SSH server. The path should be specified relative to the SSH user’s root directory.


SSH WordPress Root Path

The SSH WordPress Root Path allows you to specify the path to your WordPress installation relative to the SSH user’s root directory.


SSH WordPress Content Path

The FTP WordPress Content Path allows you to specify the path to your WordPress installation’s content directory (ie: wp-content) relative to the SSH user’s root directory.


SSH WordPress Plugins Path

The SSH WordPress Content Path allows you to specify the path to your Wordpress installation’s plugin directory (ie: wp-content/plugins) relative to the SSH user’s root directory.


Validate & Save Settings

Once you have specified your filesystem settings, scroll to the bottom of the page and click Next. Your settings will be validated and you will be asked to click Next once more to save the settings permanently.