The Composr repository is a user-friendly representation of Composr's data, which is typically stored in a database and on the filesystem. It presents the data in an easily accessible format using the JSON standard and can be accessed as a folder on your computer via WebDAV.
Commandr is a command-line interface designed for experienced system administrators who prefer using a command line over a GUI. It supplements the Composr Admin Zone, allowing you to execute commands in the form of:
PHP code (prefix :)
SQL database queries (prefix @) (queries must be executed one at a time; semi-colon separation is not supported)
Shell commands (prefix #)
Commandr-code scripts (store in the Composr filesystem's bin directory, and just type the name of the script)
Commandr-code commands (no prefixes)
You can access Commandr via the Admin Zone > Tools > Commandr or using the Commandr button in the footer.
Are there alternative chat solutions that integrate with Composr?
Answer
Yes, you can integrate third-party chat solutions with Composr. For example, CometChat is a commercial chat system that provides a Composr integration. You can also leverage video chat services like Talky, Jitsi, or appear.in by embedding links within your chat templates. For sales-chat needs, consider integrating a dedicated live chat platform like Comm100.
Are there any limitations to the Composr Chat system?
Answer
While the Composr Chat system provides robust chat and IM features, it does have some limitations. Currently, it does not support video chat, sales-focused chat features, desktop app integration, or optimal performance for very high volumes of concurrent users. Additionally, it is only near real-time as Composr queries for new messages using AJAX at a set interval.
Are there any safety guidelines for younger users?
Answer
It's crucial to emphasize safety, especially for younger users. Encourage them to follow these guidelines: never arrange to meet anyone from a chatroom in person, be cautious about sharing personal information, and report any suspicious behavior to moderators.
Yes, you can download logs of any chat conversation. Simply navigate to the chatroom, click on the "Download chat logs" link, specify the desired date/time range, and the system will generate a downloadable log file for you.
Composr offers a range of moderation features. Moderators can edit or delete messages, ban disruptive users, and delete entire chatrooms if necessary. Inline moderation links are available within chatrooms for quick actions, while the Admin Zone provides comprehensive moderation tools for managing chat content and user behavior.
Chatcode is a system of simple commands that you can embed within your chat messages to perform advanced actions. These actions include sending private messages to specific users within a chatroom, interacting with automated bots, sending chatroom invitations, and even creating new chatrooms.
The chat system utilizes AJAX technology, enabling dynamic updates without requiring page reloads. It includes a "Chat Lobby" where users can view available chatrooms and manage their friend lists for instant messaging. Users can join chatrooms to participate in group conversations or engage in private conversations with friends.
Composr Chat is a feature built into the Composr CMS that provides both chatrooms and instant messaging capabilities. It offers real-time, text-based communication for users on your website.
How can I ensure my website complies with email marketing laws?
Answer
Email marketing laws like CAN-SPAM protect recipients' rights to unsubscribe. Your website must include a clear 'List-Unsubscribe' header in every email, offer an easy unsubscribe process, and respect unsubscribe requests promptly. Composr provides built-in mechanisms, including an unsubscribe endpoint and support for the List-Unsubscribe header, to facilitate compliance.
What are my responsibilities regarding user privacy?
Answer
You must have a comprehensive privacy policy that details the personal data you collect, its usage, and if it's shared with third parties. Laws like GDPR have strict requirements, including logging data access, data purging, and security measures. California law mandates specific elements in your policy, like handling "Do Not Track" requests and a clear process for communicating changes.
Composr has an automatic Privacy Policy generator block to help you get started. This is used by default.
A well-defined rules page is crucial for setting expectations for user behavior and outlining consequences for violations. It should cover a range of offenses with appropriate punishments, reference relevant laws, and assign legal responsibility to users. Composr provides default rules pages that can be customized, and this page is displayed to users upon joining the site.
What are the key legal considerations for running a website?
Answer
Several legal aspects need careful attention when operating a website, especially for large or corporate sites. These include establishing clear rules and terms of service, adhering to privacy laws like GDPR and California's regulations, managing personal data responsibly, complying with email marketing regulations like CAN-SPAM, ensuring website accessibility, addressing eCommerce regulations, and understanding liability for content and user actions.
How do data-tpl and data-view behaviors work in Composr's JavaScript?
Answer
Composr uses data-tpl and data-view behaviors for associating HTML templates and JavaScript views, respectively. This facilitates clean separation of presentation and logic:
data-tpl: Used with the $cms.behaviors.initializeTemplates function and PARAMS_JSON tempcode directive to bind JavaScript logic to HTML templates.
data-view: Used with the $cms.behaviors.initializeViews function to associate JavaScript view classes (inheriting from $cms.View) with specific HTML elements.
How does Composr implement the Model-View-Controller (MVC) pattern?
Answer
Model/API: The sources directory primarily houses scripts forming the Model/API, handling data logic and business rules.
View: Templates in themes/default/templates represent the View, responsible for presenting data to the user. Comcode pages can also be considered part of the View.
Controller: Entry scripts like index.php and site/dload.php act as front controllers, directing requests. Modules and blocks, residing in */pages/modules and sources/[mini]blocks, respectively, serve as controllers, managing user interactions and determining which View to render.
Can I translate my content into multiple languages?
Answer
Yes, Composr supports multi-language content. You can enable this feature by:
Installing multiple language packs: Make sure you have at least two language packs installed.
Enabling the Conversr multi-language option: Go to Admin Zone > Setup > Configuration > Site options > Internationalisation.
Running a Commandr command: Execute the necessary command to set up the database structure for multi-language content (unless you already enabled Support content translations when installing).
Once enabled, you can translate your content into different languages and allow visitors to choose their preferred language.
My language uses gendered descriptors. How can I handle this in Composr?
Answer
Composr offers solutions for languages with gendered descriptors:
Template editing: You can modify templates to use different language strings based on user gender. This involves adding Tempcode logic to dynamically select the appropriate string.
Custom Profile Fields: Create a Custom Profile Field for "Gender" and use it to conditionally display gendered language strings in templates.
These methods allow for flexible handling of gendered language variations.
Language strings are phrases or pieces of text used throughout Composr. They're identified by unique codenames, like WELCOME_MESSAGE. These strings are stored in .ini language files and used to display text in the user interface.
By translating language strings, you change the text displayed on your website without modifying the underlying code.
