REQUIREMENTS:
- PHP >= 5.0.0
- WORDPRESS >= 2.6.x
- WORDPRESS MU >= 2.6.x
- MYSQL >= 4.0
INSTALLATION:
- WordPress: just copy whole cimy-user-extra-fields subdir into your plug-in directory and activate it
- WordPress MU
there are two supported ways of using this plug-in under WordPress MU:- Unique registration
If you want that ALL Blogs on your MU installation follow the same registration with the same fields this is the case for you.
Every blog will have shared registration page and only the site administrators (of the whole MU installation) can change it.
- unpack the package under ‘mu-plugins’ directory, be sure that cimy_user_extra_fields.php is outside Cimy folder (move it if necessary), then go to “Site Admin -> Cimy User Extra Fields”, press “Fix the problem” button and confirm - Per-Blog registration
If you want that every single Blog can define its own Extra Fields then you should choose this installation.
Every registration will have Extra Fields defined by single blogs, every user will have anyway WordPress fields shared with ALL Blogs, this how it works
WordPress MU.
- unpack the package under ‘plugins’ directory; BE sure that cimy_uef_mu_activation.php is installed under ‘mu-plugins’ directory
- then every single blog will have it under “Plugins” section
- Unique registration
UPDATE FROM A PREVIOUS VERSION:
- go to Cimy User Extra Fields admin options, press “Fix the problem” button and confirm
HOW TO ASSIGN A DEFAULT VALUE TO THE EXTRA FIELDS:
- You can assign a default value using the VALUE textarea in the admin panel.
- You can use URL (only for registration page), example:
http://www.exampleofmywebsite.it/wordpress29/wp-login.php?action=register&FIELD_01=test1&FIELD_02=test2
FIELD_01 and FIELD_02 are two existing fields that will get default assignment with string “test1″ and “test2″.
Note 1: Field name should be upper case otherwise won’t be recognized.
Note 2: These two methods can be used together, but remember that URL has higher priority.
FUNCTIONS USEFUL FOR YOUR THEMES OR TEMPLATES:
[Function get_cimyFieldValue]
NOTE: password fields values will not be returned for security reasons
This function is all you need to retrieve extra fields values, but in order to retrieve all power from it you have to understand all different ways that can be used.
USAGE:
$value = get_cimyFieldValue($user_id, $field_name, [$field_value]);
In ALL cases if an error is occured or there are no matching results from the call then NULL is returned.
EXAMPLE:
see Readme file
[Function get_cimyFields]
This function returns an array containing all extra fields defined by the admin ordered by the order defined in the option page, if there are no fields an empty array is returned.
USAGE:
$allFields = get_cimyFields([$wp_fields], [$order_by_section]);
EXAMPLE:
see Readme file
HOW TO USE PICTURE SUPPORT:
see Readme file
KNOWN ISSUES:
- if you add too many fields in the “A&U Extended” menu they will go out of frame
- some rules are applied only during registration (apart editable and visibility rules and max length for text and password fields only) – this has been fixed using Wordpress >= 2.8.x and Cimy User Extra Fields v.1.5.0-beta1 or greater
- some rules are never applied if you are using PHP 4.x please update to PHP 5.x as stated in the REQUIREMENTS
- registration date cannot be modified
- using WordPress password to let user customize its password works, but has one issue:
- on WordPress email received will contain wrong password (generated by WordPress), this due to WordPress limitation
- on WordPress MU email received and activation page contain correct password, no issues!
- picture and avatar upload is disabled during registration under WordPress MU, will be possible once user is activated
- if you change order or remove fieldsets you may need to set all extra fields’ fieldset assigment again
- dropdown issues:
- custom value is not supported
- comma is not allowed as it is the delimiter
