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.
Composr follows a rolling release model. This means:
New major/minor versions are released as they are ready.
Patch releases, primarily containing bug fixes, are only released for the latest supported major/minor version branch.
Users are responsible for staying updated to the latest release or applying necessary hotfixes.
This policy allows developers to focus resources on the latest versions and encourages users to leverage the ongoing improvements. You can find the release status on the Composr maintenance status page.
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 are cleanup tools in Composr and how do I use them?
Answer
Cleanup tools assist with website maintenance by deleting unnecessary data and optimizing database tables. They are divided into "De-cachers" and "Optimizers". You can access them through: