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.
Constructive design feedback is valuable. To provide effective feedback:
Be specific and detailed. Identify particular issues and provide clear examples.
Offer solutions. Suggest improvements or provide mockups demonstrating your ideas.
Avoid vague statements. General comments like "it looks dated" are unhelpful.
Understand design constraints. Consider factors like modularity, generality, feature density, compatibility, performance, and the subjective nature of design.
Directly reporting specific design bugs to the tracker or redesigning Composr interfaces yourself are excellent ways to contribute.
Be comprehensive and self-contained. Provide all necessary information and context for the developers to understand your suggestion.
Focus on widely beneficial features. Esoteric suggestions are less likely to be implemented.
Understand developer constraints. Feature development depends on factors like developer availability, funding, and project strategy.
Consider sponsoring features. Financial contributions can prioritize the development of desired features as it affords developers the time to implement it.
What is a banner wave, and how is it different from a banner rotation?
Answer
A banner wave displays all banners within a specific type as a single advertising block, similar to a list of sponsors. In contrast, a banner rotation randomly displays banners from a set based on factors like display likelihood.
You can add a banner wave using the main_banner_wave block and configure it to show a specific number of banners or all banners within a type.
What is a banner network, and how can I create one?
Answer
A banner network is a system for exchanging banners between websites. You can create a banner network in Composr by associating banners with specific websites.
When a site joins your banner network, you provide them with an iframe code to display banners from your rotation. Composr uses a "hit balancing" system where sites in the network receive banner impressions based on the clicks they generate for other sites in the network.
Yes, by enabling the "Permissions" configuration option in the Admin Zone (Admin Zone > Setup > Configuration > Feature options > Banners), you can control which usergroups can see individual banners. This feature allows for banner targeting and prevents inappropriate banners from being shown to specific audiences, such as adult banners to minors.
What are the different types of banner deployment agreements?
Answer
There are three types of banner deployment agreements:
Permanent: These banners are always displayed as long as there is available space.
Campaign: These banners have a limited number of impressions or clicks before they stop displaying. They can be associated with specific campaigns and can have their hits increased if needed.
Default: These banners are displayed only when there are no permanent or campaign banners available to show.
The system displays permanent and campaign banners with a 50:50 split.
What should I do if URL Schemes are not working properly?
Answer
If URL Schemes, which rely on web server rewrites, are not functioning correctly, you can disable them using the http://yourbaseurl/config_editor.php script. Enable the option "Whether to block the URL Scheme (mod_rewrite)" to override the main configuration setting.
How can I reset a forgotten account password in Composr?
Answer
If you have access to phpMyAdmin:
Access the f_members table.
Find the row corresponding to the user whose password needs to be reset.
Edit the row, setting m_pass_hash_salted to the new password using MD5 encryption, clearing m_pass_salt, and setting m_password_compat_scheme to 'md5'.
If you have FTP access:
Obtain your IP address.
Edit your _config.php file, setting $SITE_INFO['backdoor_ip'] to your IP address. This enables a temporary backdoor login for your IP address, bypassing security restrictions.
Remove the backdoor entry after logging in and resetting the password through standard means.
Caution: Using the backdoor method is a security risk and should be done with extreme caution.
My Composr installation seems corrupted. How can I repair it?
Answer
Composr offers several tools and methods for repairing corrupted installations:
Integrity checker: The upgrader tool, accessible via http://yourbaseurl/upgrader.php, includes an integrity checker that identifies outdated or corrupted files.
MySQL table repair: The Admin Zone > Tools > Cleanup tools provides access to MySQL table repair functionalities. Alternatively, use phpMyAdmin or your web host's database management tools for more direct control.
Safe Mode: Access safe mode via the bookmarked link from the setup wizard or by adding &keep_safe_mode=1 to any website URL. This disables custom themes and caching, helping isolate problems caused by themes or custom code.
