How do I set the correct file permissions for Composr?
Answer
If you're using the quick installer, it will handle file permissions automatically. On a suEXEC-style server, default permissions (744 for directories and 644 for files) are usually sufficient. However, _config.php should have 600 permissions for security.
Without suEXEC, specific directories (e.g., caches, uploads) and files (e.g., _config.php) require 777 (full access) or 666 (read/write) permissions. The fixperms.php script can automate this process on Linux and Windows.
What are the prerequisites for installing Composr?
Answer
Before installing Composr, ensure your web host meets the minimum requirements. Familiarize yourself with your web host's control panel (e.g., Plesk, cPanel), which you'll use to manage databases, subdomains, and other settings. Gather your SFTP/FTP credentials (hostname, username, password), usually emailed upon signup. Set up a MySQL database and note its details: hostname (often 'localhost'), username, password, and database name. Ensure the database user has full read/write/administer access to the database.
What tools are available for debugging Composr code?
Answer
Composr offers a code quality checker addon that helps identify various types of errors, including parser errors, run-time errors, and logical errors. This tool can significantly reduce debugging time and enhance code reliability. It is available through the testing_platform addon.
Composr emphasizes clean, well-structured code with a focus on readability and maintainability. Key standards include proper indentation, consistent use of comments, and clear function headers with type definitions. Remember: beautiful code leads to better functionality and collaboration!
The Code Editor is a web-based tool for editing Composr code files directly on the server. It requires password authentication and automatically manages overrides within _custom directories.
Composr allows exporting addons as TAR files, containing all necessary files and an addon.inf file for metadata. You can import these addons to share and reuse them across different Composr installations.
To do this, make your necessary files for the addon in the Composr installation, and then go under Admin Zone > Structure > Addons > Export addon. You can select the relevant files for the addon, provide information about the addon, and then download the TAR file (which can then be imported on other Composr sites).
What other methods exist for featuring content in Composr?
Answer
Random Quotes: The quotes feature allows you to display a rotating selection of quotes on your site.
Community Billboard (Requires Addon): The Community Billboard addon provides a dedicated space for displaying important announcements or community messages.
Can I display forum content in a prominent way on my Composr site?
Answer
Absolutely! Composr provides several blocks designed for featuring forum content:
News-Style Blocks: side_forum_news, main_forum_news, and bottom_forum_news display forum topics in a news format, ideal for forums used for news posting.
Topic-Focused Block: main_forum_topics showcases recent topics from specific forums, allowing you to highlight active discussions or important announcements.
What is the difference between using the main_awards block and directly selecting content with the main_content block?
Answer
Both blocks can feature content, but they offer different approaches:
main_awards: Provides a structured system for managing featured content through award assignment, archives, and optional point rewards. Requires active management to update award holders.
main_content: Offers direct control over specific content or allows random selection from chosen categories. May require manual updates or adjustments.
How do I feature specific content items on my Composr site?
Answer
You can feature content using various methods:
Blocks: The main_content block allows you to display specific items by content type and ID or randomize content from selected categories.
Awards: Create awards for different content types and assign them to specific items. You can then use the main_awards block to display current award holders. Awards also integrate with points to credit points to award holders. And you can be reminded on the staff checklist to assign a new award every configurable amount of time.
Advanced Embedding: For greater control, use the main_include_module block to embed entire module screens within other content.
Composr includes a bounce filter tool that helps you remove bounced email addresses from your subscriber list. To use this tool, you'll need:
The PHP IMAP extension enabled on your server.
A dedicated folder on your email server to collect bounced emails.
The bounce filter tool scans the specified folder for bounce messages and lets you remove the corresponding addresses from your newsletter list. Composr will also halt attempts sending e-mails to those addresses to help prevent you from getting listed on spam blocklists.
How can I ensure my newsletters comply with data privacy regulations?
Answer
Composr provides built-in mechanisms for compliance:
Unsubscribe links: Newsletters include an unsubscribe link, allowing recipients to opt out of the newsletters.
Global unsubscribe: All Composr emails include a link to a global unsubscribe page (data/unsubscribe.php), letting users unsubscribe from all site emails.
