Loading...
 

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.

CCLite

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


1.1. Tiki/Cclite Installation Instructions

 Instructions

1.1.1. 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.

1.1.2. 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:

1.1.3. 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

1.1.4. 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

1.1.5. 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"


1.1.6. 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

        Cclite payment initiated on 2011-01-26 17:25
        Transaction Accepted
        Ref: ***********************************

1.2. Basic configuration (Tiki side)

You have to select CCLite as the payment system (done by the "Barter_Market" profile for you).

tiki6_payment_admin_cclite_00_600px_shadow.png


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:

tiki6_payment_admin_cclite_01_600px_shadow.png

1.3. 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):

cclite07_manager_09_modify_c2c1_fake_data_smaller.png

1.4. 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.

c2c_op_o_offering_bread_00.png


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".

c2c_op_o_offering_bread_01.png


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...."):

c2c_op_o_offering_bread_02_succeeded_user_folly.png


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):

c2c_op_o_offering_bread_02_failed_user_test_detail.png


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:

c2c_op_o_offering_bread_03_cclite_transaction_list.png


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:

c2c_op_o_offering_bread_03_cclite_transaction_list_detail.png


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

c2c_op_o_offering_bread_04_cclite_transaction_detail.png


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

1.5. Add a new barter node to the network

The process to have a new node added to the network is:

  1. Install Tiki (if not done already), and apply the Barter profile
  2. Request the Merchant ID to the CClite admin, and update your Tiki payment configuration
  3. 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.
  4. 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)
  5. Let the users create their offers and wants in the tiki site.
  6. Let them trade through cclite


Todo:

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


Profile to easily customize your Tiki6 site to work supporting Barter Networks:


Related pages and sites:


Development sites:


CCLite:


Former implementation of CC in Tiki:

Aliases

CC | CommunityCurrencies | CommunityCurrency | Community Currency | CCLite

doc.tiki.org

Get Started

Admin Guide User Guide

Keywords

Keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):

Accessibility (WAI and 508)
Accounting
Articles and Submissions
Backlinks
Banners
Batch
BigBlueButton audio/video/chat/screensharing
Blog
Bookmark
Browser Compatibility
Link Cache
Calendar
Category
Chat
Clean URLs
Comments
Communication Center
Compression (gzip)
Contacts (Address Book)
Contact us
Content Templates
Contribution
Cookie
Copyright
Credit
Custom Home and Group Home Page
Date and Time
Debugger Console
Directory of hyperlinks
Documentation link from Tiki to doc.tiki.org (Help System)
Docs
Draw
Dynamic Content
Dynamic Variable
External Authentication
FAQ
Featured links
File Gallery
Forum
Friendship Network (Community)
Gmap Google maps
Groups
Hotword
HTML Page
i18n (Multilingual, l10n)
Image Gallery
Import-Export
Install
Integrator
Interoperability
Inter-User Messages
InterTiki
Kaltura video management
Karma
Live Support
Login
Logs (system & action)
Look and Feel
Mail-in
Map with Mapserver
Menu
Meta Elements
Mobile Tiki and Voice Tiki
Module
MultiTiki
MyTiki
Newsletter
Notepad
Payment
Performance Speed / Load
Permissions
Platform independence (Linux-Apache, Windows/IIS, Mac, BSD)
Polls
Profiles
Profile Manager
Report
Toolbar
Quiz
Rating
Feeds
Score
Search engine optimization
Search
Search and Replace
Security
Semantic links
Shadowbox
Shadow Layers
Share
Shopping cart
Shoutbox
Slideshow
Smiley
Social Networks
Spam protection (Anti-bot CATPCHA)
Spellcheck
Spreadsheet
Stats
Surveys
Tags
Task
Tell a Friend, alert + Social Bookmarking
TikiTests
Theme CSS & Smarty
Tiki Manager
Trackers
Transitions
User Administration including registration and banning
User Files
User Menu
Watch
WebDAV
Webmail
Web Services
Wiki History, page rename, etc
Wiki Syntax
Wiki structure (book and table of content)
Workspace
WSOD
WYSIWYCA
WYSIWYG
XMLRPC

Tiki Newsletter

Delivered fresh to your email inbox!
Newsletter subscribe icon
Don't miss major announcements and other news!
Contribute to Tiki