Featured Sites: A-Z Index

H


Newest 10 Entries

Question 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.
Question How do I install Composr on Linux?
Answer After ensuring your web host meets the requirements and you have a database ready, you can install Composr on Linux using the following steps:
  • Upload the Composr files to your web directory.
  • Navigate to the install.php file in your web browser.
  • Follow the on-screen instructions, providing the required information, such as database details and administrator credentials.
  • After the installation is complete, delete the install.php file for security reasons.
Question 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.
Question 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.
Question What are some key coding standards in Composr?
Answer 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!
Question Where can I find resources for learning PHP programming?
Answer While Composr documentation doesn't cover basic PHP, resources like the official PHP documentation (

PHP: Hypertext Preprocessor

PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world.

View

), online tutorials, and the Composr API guide can help you learn.
Question What is the purpose of the Code Editor?
Answer 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.

To access it, go to yourbaseurl/code_editor.php.
Question How can I export and import custom addons?
Answer 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).
Question Can you give an example of creating a new module?
Answer Imagine creating a "Testing" module to manage collaborative testing:
  • Define purpose: Allow testers to add, assign, and track tests, with security and forum integration.
  • Design database: Plan the necessary database tables and fields to store the module's data.
  • Create module shell: Write the basic module structure based on standard Composr modules.
  • Define screens: Identify the module's screens and code their corresponding functions.
  • Utilize API functions: Use Composr's built-in API functions like create_table, add_privilege, and do_template to implement functionality.
Question What are the different ways to extend Composr functionality?
Answer You can extend Composr through:
  • File overrides: Replacing existing source files with modified versions in _custom directories.
  • New Modules/Mini-modules: Creating new modules for complex functionalities or mini-modules for simpler ones.
  • New Blocks/Miniblocks: Adding reusable content blocks.
  • New API code: Adding new PHP files to the sources_custom directory.
  • Hooks: Writing hooks to add features to specific areas of functionality.

Top 10 Entries

Question How do I debug email integration issues?
Answer
  • Email Tracking: Composr marks emails as read when processing posts. Marking an email unread will trigger re-processing.
  • Log File: Create an empty file named data_custom/mail_integration.log to capture detailed log data for troubleshooting.
Question How can I control who can post in my forums?
Answer You can manage posting permissions using Composr's usergroup system.

  • Forum View Access: Determine which usergroups can view each forum.
  • Privilege Overrides: Grant or deny specific privileges (e.g., posting) to usergroups within a forum.
  • Bypass Validation: Allow trusted members to post without moderation (or vice versa, require validation for certain usergroups).
Question What special features does Composr's Conversr offer compared to other forum software?
Answer
  • Advanced Polls: Blind polls, forcing or setting of default options, and point-weighting.
  • Private Topics: More sophisticated than traditional private messages.
  • Forum Introduction Questions: A flexible way to control access and encourage engagement (e.g. forum-specific rules or forum passwords).
  • Cascading Topics: Pinned topics that appear in multiple forums.
  • Integrated Moderation: Streamlined moderation tools within the forum interface.
Question How do topic polls work?
Answer Topic polls are a powerful tool for gauging opinion within discussions. You can:

  • Control Result Visibility: Choose whether results are visible before voting.
  • Require Topic Reply: Force users to reply to the topic before voting.
  • Show Voter Identities: Optionally display which members voted for each option.
  • Allow Vote Revocation: Let voters change their vote while the poll is open.
  • Set Voting Close Time: Define a specific date or time for the poll to close.
  • Restrict Selections: Limit the number of options voters can choose.
  • Allow Guest Voting: Enable voting for unregistered users.
  • Weight Votes by Points: Give more influential members greater voting power (requires the points addon).
Question What are the different types of posts in Composr forums?
Answer
  • Regular Posts: Standard posts made by members within a topic.
  • Quick Replies: Shorter replies made directly from the topic view.
  • Anonymous Posts: Members can choose to post anonymously, appearing as a guest. Staff can track the actual user if needed.
  • Emphasised posts: Posts made by staff (or marked by staff) which are highlighted to draw attention as they are important.
  • Whispers: Private messages embedded within public topics, allowing for side conversations.
  • Private Topic Posts: Private messages sent between specific members (e.g. an on-site "inbox").
Question Can I integrate email with my forums (mailing list)?
Answer Yes, you can enable email integration for each forum individually. This allows members to post and receive updates via email.

Requirements:
  • PHP IMAP extension installed
  • System scheduler (Cron) running
  • IMAP-compatible mail server

Recommended:
  • Mail server enforces SPF and DKIM for email validation
  • Mail server limits email size to prevent abuse
  • System scheduler runs frequently (e.g., every minute) so members get prompt updates
Question How do I organize my forums effectively?
Answer
  • Structure: Composr's forums follow a hierarchical structure. You can create forum groupings, forums, and sub-forums (and sub-sub-forums etc) in that order of hierarchy.
  • Strategies: Avoid creating too many forums, which can dilute activity. Start with a few well-defined forums and expand as needed.
  • Permissions: Use Composr's permission system to control access to forums and features. For example, you can create private staff forums.
Question How can I keep track of activity in busy forums?
Answer Composr provides several tools to help you stay up-to-date with forum activity:

  • Virtual Forums: Special forums like "Posts since last visit" and "Topics with unread posts" provide filtered views of recent activity.
  • Read Status: Topics with unread posts are displayed in bold with a jump-to-first-unread link. You can manually mark topics or entire forums as read or unread.
  • Notifications: You can enable email notifications for specific topics or forums, either manually or automatically based on your activity.
Question What security measures should I consider for local payments?
Answer While Composr supports local payments (Authorize.Net), it requires high PCI compliance. Ensure you adhere to the PCI Data Security Standard (PCI DSS) guidelines, including secure coding practices, firewalls, intrusion detection systems, regular security audits, and staff screening.
Question How can I audit my eCommerce activity in Composr?
Answer Composr provides tools for monitoring your eCommerce activities:

  • Sales list management: Cancel purchases, view sales history, and manage refunds (Admin Zone > Audit > eCommerce > Sales list management).
  • Charts: Generate profit/loss accounts and cash flow diagrams for specific periods (Admin Zone > Audit > eCommerce, and Admin Zone > Audit > Site statistics).
  • Manual transactions: Record transactions outside of Composr for accurate accounting (Admin Zone > Audit > eCommerce > Manual transaction).