Cimy User Manager – documentation

REQUIREMENTS:

  • PHP >= 5.2.4
  • WORDPRESS >= 4.3.1
  • MYSQL >= 5.0

INSTALLATION:

  • just copy whole cimy-user-manager subdir into your plug-in directory and activate it

To import users and their data you must create a CSV file where every row represents an user and every string is divided by a comma ‘,’ and delimited by double quote ‘”‘

The first row must contains one or more of these fields (order has no influence):
% USERID % – specify the existing userid (if valid then the username will be ignored)
% USERNAME % – specify the existing username or if not existing then create a new one (if specifically requested by the user)
% EMAIL % – change the e-mail (should be unique and is mandatory for new users)
% ROLE % – change the role, choose between: [subscriber|contributor|author|editor|administrator]
% PASSWORD % – change the password, if an empty password is provided then a 12 alpha/numeric length random one will be generated automatically
% FIRSTNAME % – change the first name
% LASTNAME % – change the last name
% NICKNAME % – change the nickname
% DISPLAYNAME % – add a display name
% NICENAME % – change the nice name
% WEBSITE % – change the website
% AIM % – change the AIM
% YAHOO % – change the Yahoo IM
% JABBER % – change the Jabber/Google Talk
% DESCRIPTION % – change the description
CIMY_UEF_FIELD_NAME – insert data into the Cimy User Extra Fields with the given name

  • for radio: specify the exact label (case sensitive!) of the checkbox you want to select
  • for checkbox: use 0 or 1 for selecting or deselecting it
  • for dropdown: specify exactly one of the selectable choices (case sensitive!)

starting from the second row every user (new or existing one) should be follow the same order specified in the first row.

EXAMPLE:
In this example there are 3 users, one specified by username (admin) and other two by userid; notice that when you should want to leave it blank just put a comma, like Laura has no userid specified and no description.
If you want to add commas to your fields then you have to choose another fields separator in your CSV file and then specify it in the corresponding option before importing.

“% USERID %”,”% USERNAME %”,”% FIRSTNAME %”,”% DESCRIPTION %”,”EXTRA_FIELD_01″,”EXTRA_FIELD_02″
“2”,””,”Marco”,”Hey this is me!”,”text into field 01″,”text into field 02″
“”,”admin”,”Luca”,”The administrator.”,”extra field!”,”again!”
“4”,””,”Laura”,””,””,””,””

PERSONALIZED EXAMPLE:
The best example is to export your current users’ data to a CSV file using this plug-in and modify it following the same scheme.