Documentation

Installing Plugin

There are 2 ways to install WordPress plugins.

Upload via WordPress Admin. You can easily add a new plugin by uploading a zip archive of the plugin from your local computer.

Manual Plugin Installation. In some cases, you may need to manually upload a plugin directly using an SFTP client.

1. Method: Manual Upload via WordPress Admin

If you have a copy of the plugin as a zip file, you can manually upload it and install it through the Plugins admin screen.

  1. Navigate to Plugins > Add New.
  2. Click the Upload Plugin button at the top of the screen.
  3. Select the zip file from your local filesystem.
  4. Click the Install Now button.
  5. When installation is complete, you’ll see “Plugin installed successfully.” Click the Activate Plugin button at the bottom of the page.

2. Method: Manual Plugin Installation

In rare cases, you may need to install a plugin by manually transferring the files onto the server. This is recommended only when absolutely necessary, for example when your server is not configured to allow automatic installations.

This procedure requires you to be familiar with the process of transferring files using an SFTP client.

Warning: this process may put your site at risk if you install a WordPress plugin incompatible with the current version or from an unreliable source. Back up your site completely before proceeding.

  1. If your plugin is in the form of a zip file, unzip the contents. You should see a single folder named after the plugin.
  2. Look in the plugin folder for a readme.txt file. Read the file to confirm that this is the correct plugin, and to look for any special instructions.
  3. Connect to your WordPress server with your SFTP client.
  4. Copy the plugin folder to the wp-content/plugins folder in your WordPress directory. This installs the plugin to your WordPress site.
  5. Navigate to your Plugins admin screen and locate the newly uploaded plugin in the list.
  6. Click the plugin’s “Activate” link.
What is Before or After Fields?

There is two options to create custom fields for registration form. Woocommerce default registration form has, username, email and password fields.

If you add your custom fields in to the before fields, your fields will be displayed above of the default Woocommerce fields.

If you add your custom fields in to the after fields, your fields will be displayed below of the default Woocommerce fields.

Adding Custom Field

Label: Title or label for your custom field.

Active: Enable/Disable field.

Type: Custom field’s type. Text, email, textarea or others.

Width: Choose field’s width. It can be full or half width. For working this option, styles must has correct css codes.

ID: This value must be unique. For example, if your label is “Your name”, write ID as your-name.

Description: Write custom field’s description or details.

Placeholder: Custom field’s placeholder text. It works like description but with less letters.

Default Value: Predefined value.

Required: Make field required.

Required Message: This section will visible when “Required” set as “Yes”. This message will displayed when field leave blank in registration form.

Show in Profile (Admin): Display custom fields in admin area. Only admins can see and edit this fields.

Show in Profile (User): Display custom fields in frontend. User can see and edit this field.

Advanced Options

If you want to see advanced options, you must set Advanced Options to “Yes”.

Max Length: This option works only text, email, url, password and number fields. It limits input length.

Priority: This field is adding “data-priority” attribute to field’s wrapper. Doesn’t change fields order. You can change field’s order with drag & drop.

Autocomplete: This option is adding “autocomplete” attribute. It is usefull for browsers auto suggestions. Check for more details here.

Wrapper Class: Add custom css classes to field wrapper. Place classes with comma separated.

Label Class: Add custom css classes to field title. Place classes with comma separated.

Field Class: Add custom css classes to field. Place classes with comma separated.

Autofocus: This option is adding autofocus attribute. Use this option for only one field. When user open the page, this field will focued.

Custom Attributes: Add custom attributes for field.

Conditions: Create conditional display for custom fields.

Conditional Display

Click “+ Add Condition” button for creating conditional display.

You can create multiple conditions for displaying custom field. It is very simple. Lets explain with an example.

Create a text field, and set this field’s ID as my-text-field.

Create an url field for conditional display. We will show this field only when user write abc letter into my-text-field.

For this, add a condition for url field. And place my-text-field to Field ID. Place abc to Field Value. Its done. After this, url field will be hidden in registration form. But when an user write abc in the text field, url field will be visible.

There is only one imported thing. It is the field’s id.

Default WooCommerce Fields

Woocommerce has default user fields. Like a first name, last name, billing address… This fields available only after registration. And users can access only their profile page.

But with our plugin, you can activate for registration form with single click.

Set field first opiton as “Show” for the display. Write your custom label and make it required or optional. It is simple.

Settings

Global Prefix: Plugin fields saved with custom prefix. For example, if you create text field with “my-text-field” ID. It will register “woorefi_my-text-field”. You can change global prefix. It is optional. If you don’t advanced user, do not change this.

Delete Plugin Data When Uninstall: Your custom fields, license code and all settings will saved to database. If you delete all with plugin installation, open this setting.