Loading...
 
Skip to main content

History: Community Currencies

View published page

Source of version: 19 (current)

Copy to clipboard
            ! Community Currencies (CC)
This feature has been introduced in ((Tiki6)), and it allows to use community-defined currencies to support trading within Barter Networks using a community-trust based ((Payment)) system.

{CENTER()}{img src="http://code.google.com/p/cclite/logo?cct=1261122860" class="reflect" alt="CCLite"}{CENTER}
In its current design it requires an external free software package called __CCLite__ to handle the transactions out of tiki. This is intentional, since the goal is that not only Tiki-based sites but also other Content Management Systems (Elgg, Joomla, Drupal, ...) can use the same CCLite installation to support intertrading among communities and softwares.

Basic Terminology
* "Registry": Barter Network


!!# Tiki/Cclite Installation Instructions
{REMARKSBOX(type="information",title="Instructions")}
!!!# Known limitations
* Users must exist in both web sites with exactly the same username (case sensitive)
** As of July 2010, users must be registered in both sites. In the future we expect that Tiki is able to create users in the CCLite installation with the same or other name, and keep that information in a field of the ((Group tracker)) item for each registered user in the Tiki site.
* Registry names and their corresponding currencies must be defined in both sites with the same names (case sensitive)
* payments in community currency are allowed based on the budget of that user account in CClite. 
* there is too little error reporting (so far) when something goes wrong. Some improvements to the cclite code need to be added to make it better.

!!!# Requirements

* Tiki6.x (6.1+) and CClite 0.7+.
* PHP CURL extension
** See your PHP Info page and check for a "curl" section: e.g. "example.com/tiki-phpinfo.php"
** If it's not there:
*** See http://php.net/manual/en/curl.setup.php for general info
*** On Debian or Ubuntu do (usual warnings about sudo)
+++ {CODE()}sudo apt-get install php5-curl
sudo /etc/init.d/apache2 restart 
{CODE}

!!!# Install Barter_Market profile
* Go to tiki-admin.php?page=profiles (logged in as admin)
* Search for "barter" in the Profile box on the default repository
* Click the name "Barter_Market" that should be the only result
* Fill in the options such as "Browser title", "Site subtitle" and "sitetitle" (leave the cclite and barter ones as they are to use c2c.ourproject.org)
* Once the profile has been applied:
** Read the Instructions page (added by the profile)
** Go to page Profile_Barter_Offer_Template and approve the plugin
** When it's written, do the same on Profile_Barter_Want_Template
** Clear smarty templates_c on Admin -> Tiki Cache/Sys Admin

!!!# Install cclite
The installation of cclite is beyond the scope of this page. Check its own manual for the installation of you own cclite, if you need to.  See:
[http://www.hughbarnard.org/?q=node/3]

For the time being, you can request to use the common installation some communities have at: 
http://c2c.ourproject.org

!!!# Connect your server to cclite
* Send an email to cclite@NOSPAM@intercanvis.net (or the contact email for any other cclite installation) containing the IP for your server and the Tiki server address
* You will be sent back the "merchant key" on return
* When you have the merchant key go to tiki-admin.php?page=payment and enter the merchant key and click "Change Settings"


!!!# Test a transaction
* Create another "normal" user in your Tiki (maybe we should have a default test user there)
* Go to http://c2c.ourproject.org and create a user with the same user name there
** Validate that user (if relevant still?)
* Go back to your Tiki
** Log in or switch user to your new non-admin user
** Go to the Offers page,
*** pick one of the items and click "Buy now!",
*** and then "Trade with Cclite"
*** If it all works you should get a message saying
+++ {QUOTE()}Cclite payment initiated on 2011-01-26 [17:25]
Transaction Accepted
Ref: ***********************************  
{QUOTE}

{REMARKSBOX}
!!# Basic configuration (Tiki side)
You have to select CCLite as the payment system (done by the "Barter_Market" profile for you).

{CENTER()}{img fileId="299" alt="" rel="box[g]" class=reflect}{CENTER}

Then you have to provide the details for the CCLite installation, so that Tiki and CCLite can talk to each other properly. See an example below:

{CENTER()}{img fileId="300" alt="" rel="box[g]" class=reflect}{CENTER}  

!!# Basic configuration (CCLite side)
You have to provide some details for your basic cclite installation (See the CCLite manual).

And then, each registry that you create, needs to have some basic details also, which comprise a registry name, description, email, among others (''to be continued''):

{CENTER()}{img fileId="308" alt="" rel="box[g]" class=reflect}{CENTER}  

!!# Usage
The usage is pretty intuitive, once the profile "Barter Market" is applied to your Tiki installation.

You have a list of items offered or wanted shown in a page, and you select one of them. Then you have the option to:
* give the amount (in the community currency specified in the item) to person offering it, in order to close the transaction
* get in contact with that user first, to agree on details or state of that item offered or requested.

{CENTER()}{img fileId="302" alt="" rel="box[g]" class=reflect}{CENTER}  

Once you click on the button "__Buy now__", you, you initiate a payment request, which you can pay with CCLite or by other means such as plain barter in exchange of some other good or service, etc. If you want to trade with CCLite-based community currency, you can click on the button "__Trade with CClite__".

{CENTER()}{img fileId="301" alt="" rel="box[g]" class=reflect}{CENTER}  

This will initiate the payment, provided that you have enough amount in that currency in you CClite account. In such case, you'll see a message saying "Transaction accepted" followed by some code ("Ref: XXXX...."):

{CENTER()}{img fileId="304" alt="" rel="box[g]" class=reflect}{CENTER}  

If the user is not registered in the CCLite site, a some message will be shown indicating it (for user "test" in this example below):

{CENTER()}{img fileId="303" alt="" rel="box[g]" class=reflect}{CENTER}  

The previous successful transaction will be recorded also in the CCLite side, at the "__Transactions__" sections, once loged as manager or user with enough rights:

{CENTER()}{img fileId="306" alt="" rel="box[g]" class=reflect}{CENTER}  

As seen in this detailed image, the last rows correspond to the recent transaction that we have seen in the previous images from the linked Tiki site:

{CENTER()}{img fileId="305" alt="" rel="box[g]" class=reflect}{CENTER}  

If we click in the "Show" button in CCLite, we will see the full details of that transaction, as stored in the CClite server:

{CENTER()}{img fileId="307" alt="" rel="box[g]" class=reflect}{CENTER}  

For more information for the time being, you can see it in action at 
http://c2c.ourproject.org/tiki

!!# Add a new barter node to the network
The process to have a new node added to the network is:
# Install Tiki (if not done already), and [http://profiles.tiki.org|apply|box] the [http://profiles.tiki.org/Barter|Barter profile|box]
# Request the Merchant ID to the CClite admin, and update your Tiki payment configuration 
# Send to the CClite admin the ip of the server where your Tiki is sintalled, in order to have it added to the cclite configuration.
# Create users with the same username in the CClite installation as they have in the Tiki site 
+ (in the future, this will be more flexible)
# Let the users create their offers and wants in the tiki site.
# Let them trade through cclite

Todo:
# Show the list of transactions and status of the budget for users in their userpages
# Show the list of items offered and wanted (as open, pending, closed) in their user pages. 

!!# Links

Profile to easily customize your Tiki6 site to work supporting Barter Networks: 
* http://profiles.tiki.org/Barter_Market

Related pages and sites:
* http://intercanvis.net

Development sites:
* http://c2c.ourproject.org
* http://dev.tiki.org/cc

CCLite: 
* Sourceforge page: http://sf.net/projects/cclite
* Author's page: http://www.hughbarnard.org/?q=node/3
* Email list: http://groups.google.co.uk/group/cclite

Former implementation of CC in Tiki:
* ((Mod cc))
* http://cc.tiki.org
 
-=Aliases=-
(alias(CC)) | (alias(CommunityCurrencies)) | (alias(CommunityCurrency)) | (alias(Community Currency)) | (alias(CCLite))