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.
How can potential conflicts between staff members be avoided (regarding content moderation)?
Answer
Composr incorporates "conflict detection" features to prevent staff from accidentally overwriting each other's work. When multiple staff members attempt to edit the same resource simultaneously, a warning message appears, prompting communication and coordination.
Open communication and transparency are crucial. Encourage staff to share their ongoing tasks and plans with each other to prevent overlaps and potential conflicts. Utilizing shared tools like the staff checklist and private forums can further facilitate coordination.
What should be considered when assigning roles and responsibilities to staff?
Answer
When assigning roles, it's recommended to start new staff with limited responsibilities and gradually increase their authority based on performance and dedication. This fosters a sense of progression and prevents discouragement among existing staff.
Always consider the individual's skills and interests when assigning tasks. For example, someone with strong writing skills might be well-suited for managing content creation, while a technically-minded person could excel at site maintenance.
How can staff be effectively managed in a Composr community?
Answer
Successful staff management requires a mindful approach that prioritizes fostering a positive and productive environment. Key recommendations include:
Respect staff limitations: Avoid overwhelming staff with excessive workload or overly ambitious site expansions.
Active involvement: Maintain active involvement in overseeing staff activities and ensuring their effective functioning.
Open communication: Engage in regular communication, providing feedback, addressing concerns, and recognizing achievements.
Foster teamwork: Encourage collaboration and information sharing among staff members.
Lead by example: Ensure staff adhere to community rules and demonstrate expected behavior.
Empowerment and trust: Grant sufficient freedom and control to enable staff to excel in their roles.
By fostering a supportive and empowering environment, community managers can enable staff to contribute their best efforts and drive the community's success.
How should staff members be chosen for a Composr-based online community?
Answer
Choosing staff for online communities differs from traditional hiring processes due to factors like unpaid positions, varying time commitments, and remote interactions. Focus should be placed on identifying individuals with:
Genuine interest: Look for members passionate about the community and its goals.
Available time: Ensure potential staff can dedicate sufficient time to fulfill their responsibilities.
Relevant skills: Prioritize skills and experience aligned with the specific role requirements.
Maturity and discipline: Seek individuals who demonstrate responsible behavior and commitment.
Recruitment methods like directly approaching active community members or allowing the Composr points system (or the karma non-bundled addon) to identify dedicated contributors can be more effective than traditional advertising.
How can content issues be reported and addressed by staff?
Answer
Composr's content reporting system, powered by the Tickets addon, allows users to report problematic content to staff. Key features include:
Report links: "Report this" links embedded throughout the site enable users to flag content for review.
Custom reporting interface: Forums offer a dedicated interface for reporting individual posts.
Anonymous reporting: Logged-in users can choose to report content anonymously.
Ticket-based management: Reports are automatically created as support tickets, facilitating staff collaboration and record-keeping.
Comprehensive report details: Tickets include content title, type, ID, submitter information, an embedded rendering of the reported content, and the reporter's explanation.
This system ensures efficient handling of content issues, allowing staff to address concerns effectively while maintaining a transparent record of actions taken.
How can staff members collaborate effectively in Composr?
Answer
Composr offers various tools to facilitate staff collaboration:
Private forums: Dedicated forums with restricted access enable staff to discuss site operations and coordinate activities. Composr installs a staff forum by default in Conversr.
Conflict detection: When multiple staff members attempt to edit the same resource simultaneously, Composr displays warnings at the top to prevent accidental overwrites.
Staff checklist & dashboard: The Admin Zone dashboard provides a shared checklist for task management, along with space for notes and links.
Staff notifications and tickets system: Staff receive notifications about various site events, including support tickets from the "Contact Us" page, allowing for efficient issue handling.
Content notes: Staff can embed notes within Comcode or use dedicated "staff notes" fields for various content types to share information and context.
Validation and workflows: Content can be intentionally left unvalidated even by staff, enabling secondary checks before publishing. A dedicated workflows addon allows for complex approval processes with multiple stages involving different staff groups.
System-defined staff: This includes administrators and super moderators who have specific privileges within the forum/member system (Conversr).
Privilege-based staff: Anyone granted the necessary permissions for a particular situation is considered staff for that context.
Composr prioritizes flexibility by utilizing privileges over fixed roles, allowing for customized staff responsibilities. However, certain features like "staff reply" in tickets inherently rely on a pre-existing understanding of "staff."
