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.