Points escrow is a system that holds points securely during transactions involving a written agreement, often for a product or service. This ensures trust and provides a resolution mechanism in case of disputes.
Creating an Escrow: You initiate an escrow on the member's profile points tab, specifying the amount, reason, and any agreement details.
Points Held: The points are deducted from your balance and held by the system.
Agreement Fulfillment: Both parties must mark the escrow as satisfied upon fulfilling the agreement.
Points Release: Once both parties are satisfied, the recipient receives the points.
Disputes: If either party has a dispute, they can dispute the escrow, which then locks it down and notifies a staff member to review and take a resolution action.
Can I create a leaderboard to showcase top point earners?
Answer
Yes, Composr offers a leaderboard block and module to display top point holders. You can customize the leaderboard to show weekly, monthly, or yearly rankings, filter by usergroups, and exclude staff members if desired. This can encourage healthy competition and motivate members to earn points.
Go to Admin Zone > Setup > Leader-boards to create a leader-board.
Staff members with the "Moderate members' points" privilege can directly credit or debit points from members' accounts. This can be used to reward exceptional contributions, refund purchases, or penalize rule violations.
The ledger provides a transparent and immutable record of every point transaction on the website. It ensures accountability and allows members to track their point activity. Members can view their own ledger, and with the appropriate privilege, they can also see the ledgers of others.
Gift points are a separate points balance that can only be sent to other members as gifts. They cannot be spent directly or used in escrow transactions.
Gift points are earned daily based on usergroup membership and replenish independently of the regular points balance. When a member sends gift points, they become regular points for the recipient.
Yes, members can send points to each other as a token of appreciation, reward for a service, or as part of an agreement using the Points Escrow system.
Points are typically awarded immediately upon content submission to encourage participation. However, forum posts requiring validation only earn points after approval to deter spam. To further encourage high-quality content, consider using the "awards" addon to reward exceptional contributions.
Can I reward members who use specific browsers or operating systems?
Answer
Yes, Composr allows you to configure bonus points based on browser/platform criteria. You can set bonus points for members using Open Source browsers, specific operating systems, or even those who have enabled privacy features like "Do Not Track" (DNT) or "Global Privacy Control" (GPC).
What's the difference between points balance and rank points?
Answer
Points balance refers to the number of points a member currently has available to spend. This is the 'liquid' currency they can use for various actions.
Rank points represent the total points a member has accumulated throughout their time on the website. These points determine the member's rank, which can grant access to additional privileges and act as a status symbol.
What other approaches exist for mobile integration with Composr?
Answer
Other approaches, in various stages of development, include:
Tapatalk: A third-party forum app with an official Composr addon, offering a high-quality "out-of-the-box" Composr app experience.
Further Composr Mobile SDK development: Plans and issues relating to the SDK's evolution can be found on the Composr tracker, driven by commercial projects and feature sponsorship.
How does authentication work with the server-side API?
Answer
Authentication is handled automatically using cookies, similar to regular website requests. If cookies are not feasible, the response parameters device_auth_member_id_cn/device_auth_pass_hashed_cn/device_auth_member_id_vl/device_auth_pass_hashed_vl from the login endpoint can be resent as POST parameters in subsequent requests.
How do I access the server-side API for my mobile app?
Answer
The server-side API can be accessed via HTTP calls to http://yourbaseurl/data/endpoint.php. Results are returned in JSON format. The API utilizes endpoints with a 'hook' name and a 'hook type' categorization. Both REST-style and GET-parameter style requests are supported, with the latter recommended for simplicity.
What is the purpose of the Composr Mobile SDK Toolkit?
Answer
The Toolkit, part of the composr_mobile_sdk addon, aids in mirroring Composr website resources into a mobile app. It includes tools for generating iOS/Android string resources from language files and exporting theme images in a directory structure suitable for iOS/Android app image assets.
To connect to a Composr site, you will need to install the composr_mobile_sdk addon, which is not bundled. This addon provides scripting to generate app assets from the Composr site.
Composr Mobile SDK (CMS SDK) is a toolkit designed for experienced iOS and Android developers to build mobile apps that integrate with a Composr-powered website. It offers both Composr-specific integrations and a collection of standalone utilities for building apps, providing a common base between iOS and Android akin to the PHP and Composr APIs, enabling easier code porting while maintaining a native experience.
