=== Affiliates Import ===
Contributors: itthinx, proaktion
Donate link: https://www.itthinx.com/shop/
Tags: affiliate, affiliates, affiliate marketing, referral, growth marketing
Requires at least: 6.5
Tested up to: 6.9
Requires PHP: 5.6.0
Stable tag: 2.1.0
License: GPLv3

Import affiliate accounts with [Affiliates](https://wordpress.org/plugins/affiliates/), [Affiliates Pro](https://www.itthinx.com/shop/affiliates-pro/) and [Affiliates Enterprise](https://www.itthinx.com/shop/affiliates-enterprise/).

== Description ==

This plugin allows to import affiliate accounts from a text file into [Affiliates](https://wordpress.org/plugins/affiliates/), [Affiliates Pro](https://www.itthinx.com/shop/affiliates-pro/) and [Affiliates Enterprise](https://www.itthinx.com/shop/affiliates-enterprise/).

It is an extension and requires one of these to import affiliates on your site from a text file, using values separated by tabs.

It supports custom fields as defined under _Affiliates > Registation_.

For detailed usage instructions, please refer to the [Documentation](https://docs.itthinx.com/document/affiliates-import/).

For bulk imports where email notifications to new users imported are enabled, we recommend to use [Itthinx Mail Queue](https://www.itthinx.com/shop/itthinx-mail-queue/) to speed up the import process and send out notifications progressively.

The text file must be in tab-separated values format. Example of an input file:

    @user_login	user_email	first_name	last_name
    affiliate1	affiliate1@example.com	Maria	One
    affiliate2	affiliate2@example.com	Matthew	Two
    affiliate3	affiliate3@example.com	Joanna	Three
    affiliate4	affiliate4@example.com	Joseph	Four

The first line with the `@` sign indicates the column order of the fields below. Values are separated by _tabs_. You can change the order of the fields and skip any except the `user_email`.

Requirements:

- [Affiliates](https://wordpress.org/plugins/affiliates/) or [Affiliates Pro](https://www.itthinx.com/shop/affiliates-pro/) or [Affiliates Enterprise](https://www.itthinx.com/shop/affiliates-enterprise/).
- A text file in the appropriate format (entries separated by tabs) that holds information about the affiliate accounts to create.

Documentation:

- [Affiliates Import](https://docs.itthinx.com/document/affiliates-import/)

== Installation ==

1. Install and activate [Affiliates](https://wordpress.org/plugins/affiliates/) or [Affiliates Pro](https://www.itthinx.com/shop/affiliates-pro/) or [Affiliates Enterprise](https://www.itthinx.com/shop/affiliates-enterprise/).
2. Install and activate this plugin [Affiliates Import](https://wordpress.org/plugins/affiliates-import).
3. Go to Affiliates > Import on your WordPress Dashboard and import the desired affiliate accounts from an existing text file.

Note that you can install the plugins from your WordPress installation directly: use the *Add new* option found in the *Plugins* menu.
You can also upload and extract them in your site's `/wp-content/plugins/` directory or use the *Upload* option.

== Frequently Asked Questions ==

= Where can I find the documentation for this tool? =

The documentation is located at [Affiliates Import](https://docs.itthinx.com/document/affiliates-import/).

= What plugins are required to import affiliates with this tool? =

You can use any of these:
- [Affiliates](https://wordpress.org/plugins/affiliates/) (free) or
- [Affiliates Pro](https://www.itthinx.com/shop/affiliates-pro/) (premium) or
- [Affiliates Enterprise](https://www.itthinx.com/shop/affiliates-enterprise/) (premium)

== Screenshots ==

Please refer to the Documentation for details:

- [Affiliates Import](https://docs.itthinx.com/document/affiliates-import/)

== Changelog ==

The full changelog is available at [changelog.txt](https://github.com/itthinx/affiliates-import/blob/master/changelog.txt).

== Upgrade Notice ==

Tested for compatibility with the latest versions of WordPress.