Deskripzioa
Introduction
This is a WordPress plugin which will allow you to add (only at the moment) users to the Tripolis database without having to do much programming. This plugin has a partial implementation of the Tripolis API (version 2.0).
Prerequisits
To use this plugin you need to have an active Tripolis Dialogue license, and your environment should have an API user who at the minimum has access to:
- Modules
- Contact
- At least one database
- At least one workspace
Also make sure your use is a “Clientdomain Administrator” as that seems to be required in order to use the API. Don’t make the user an Interactive user as that will require the user to change his/her password every 60 days.
Pantaila-argazkiak
Instalazioa
Setup
Download and install the plugin in whatever way you are used to and activate the plugin from your plugins page.
After activation you should have a new Settings page where you need to fill in the API user credentials. The information you need to enter you should have ready. If you do not know the server, check the URL of your license login. It should match what you see there. If your environment is not in the option list, contact me.
Once the setup has been completed it will, you may start using the shortcode. To help you create a shortcode, use the shortcode generator tool found under the “Tools” menu.
Placing forms
You can place a form anywhere you can put a shortcode. By default this plugin makes it so it is also allowed in the text widget, which should ease the use of the plugin a bit.
You can also directly make a call to the shortcode from your template by adding the following code in your code
do_shortcode('<shortcode>');
MEG
The plugin is activated, but I don’t see the settings page
The plugin won’t load completely, if you do not have PHP 5.4 or higher installed on your system. Please check your php version first, if you are using an allowed version, but are still at a loss, let me know!
Can i customize the HTML?
You can override all templating done by creating a directory wp-tripolis in your theme directory and place all files there. To give you a head start you can copy the templates from the templates directory.
How can I alter fields in the subscribe form?
There are a couple of filters you can use to manipulate the fields of the form. All filters will pass 2 parameters, the value and a field definition.
- wp-tripolis_classes: allows you to add/remove classes from a field/label
- wp-tripolis_label: allows you to override the label with your own text
- wp-tripolis_value: allows you to set default values for fields (e.g. pre-fill with user info)
- wp-tripolis_required: modify which field are mandatory
- wp-tripolis_subscribe-submit-label: modify which label of the submit button
Furthermore you can use the following 2 actions to add extra content/before or after the form:
- wptripolis_before_subscribe_form
- wptripolis_after_subscribe_form
You have also two actions you can use to handle confirmation mail sending * wptripolis/subscribe/mailsent * wptripolis/subscribe/mailnotsent
And you can use the action wptripolis/subscribe
to add extra functionality after someone subscribed.
How can I alter the unsubscribe page
There are a couple of filters & actions you can use to manipulate the unsubscribe form. You can also take the standard unsubscribe page and copy it to your theme folder and customize it there. Just be sure to add the nonce and use the wptripolis_field_name() method to style your form.
The filters you can use are:
- wp-tripolis_unsubscribe-submit-label: Modify the text of the submit button
- wp-tripolis_group-label: Modify the label of a group
- wptripolis_unsubscribe_introduction: Alters the heading text
The actions that are available allow you to add content before or after the form. They are:
- wptripolis_before_unsubscribe_form
- wptripolis_before_unsubscribe_form
Can i have a profile page, where people can edit their subscriptions?
Although not currently planned, this may come in the future if enough people require it. You can always take the plugin as a start point and develop from there.
Berrikuspenak
Laguntzaileak eta Garatzaileak
“WP-Tripolis” software librea da. Ondoko pertsonek egin dizkiote ekarpenak plugin honi.
LaguntzaileakItzul zaitez WP-Tripolis zure hizkuntzara.
Garapena interesatzen zaizu?
Araka ezazu kodea; begira ezazu SVN biltegia, edo harpidetu garapen erregistrora RSS-(r)en bidez.
Aldaketen loga
0.3.1
- Added some extra servers to the selectionlist
0.3
- Made it possible to send a confirmation mail when subscribing using the directmail attribute
- Added some extra actions to the subscribe form to add some extra functionality when needed. These actions use a different syntax (slashes instead of underscores). Future releases will be using this syntax for all actions.
0.2
- Unsubscribe implementation
- Further implementation of some services
- Added a base stylesheet to make subscribe/unsubscribe forms look better by default
- Fixed some bugs
0.1.1
- Deployment fixes, which required making a new tag
0.1
- Initial release, only supports subscribe form