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 Are there any limitations to importing forum data?
Answer Yes, some limitations exist, particularly with specific forum platforms.
  • General: Private messages are often combined into private topics.
  • phpBB: Usergroup configuration and HTML entities may require manual adjustments after import.
  • vBulletin: Calendar recurrences, ratings (karma), and 'goes to coventry' are not imported perfectly. Attachments may need to be extracted directly from the live database due to potential corruption in SQL dumps.
  • Simple Machine Forum: Banning features may not import perfectly due to differences in how Composr handles bans.
Question Where can I find the import functionality in Composr?
Answer Navigate to Admin Zone > Tools > Import.
Question What data formats can Composr import?
Answer Composr primarily uses database connections for importing. However, it also supports neutral data formats like CSV spreadsheet files and importing downloads from a directory.
Question Can I import data from other platforms into Composr?
Answer Yes, Composr offers importers for several popular platforms:
  • Forum Software: Invision Board, MyBB, phpBB, Simple Machine Forum, vBulletin
  • Content Management Systems: WordPress
  • Special Importers: HTML website importer, Composr merge (for merging another Composr site)
Question How do I move my Composr website to a new server?
Answer Moving a Composr site involves transferring both the files and the database.

Files:
  • On the old server, ZIP the entire Composr directory.
  • Download the ZIP file to your computer.
  • Upload the ZIP file to the new server using SFTP/FTP.
  • On the new server, unzip the file.

Database:
  • On the old server, create an SQL dump of your database using the mysqldump command or phpMyAdmin.
  • Download the SQL dump file.
  • If your URL is changing, search and replace the old URL with the new one in the SQL dump file.
  • Upload the SQL dump file to the new server.
  • Restore the database on the new server using the mysql command or phpMyAdmin.

Important Steps:
  • File Permissions: After transferring files, ensure correct file permissions are set on the new server. You can use the fixperms.php script, the upgrader script, or manually adjust them.
  • Configuration: If database settings are different on the new server, update the _config.php file or use the config_editor.php script to change the settings for both the site and forum databases.
  • Base URL: If your URL has changed, update the base URL setting in the Installation Options editor (config_editor.php).
  • Caches: Clear the block cache using the upgrader.php script.
Question Can I integrate third-party JavaScript libraries into Composr?
Answer Yes, you can integrate third-party JavaScript libraries using various methods:
  • Direct reference by URL: Include the library's URL in your theme's HTML.
  • Composr's JavaScript API: Use Composr's API for organized inclusion and potential future compatibility benefits.
  • Manual integration: Directly include the library's code in appropriate template files.
Choose the method best suited for your needs and technical proficiency.
Question How does Composr handle user authentication with external systems like LDAP or HTTP authentication?
Answer Composr can integrate with LDAP and HTTP authentication, but these features are considered complex and may require programming experience to set up correctly. Both methods allow users to log in to Composr using their existing credentials from the external system, streamlining access and management.
Question What are the limitations of using a third-party forum driver?
Answer Using a third-party forum driver can lead to limitations. Custom profile fields of type LONG_TEXT are limited to TEXT length, cookie integration is not officially supported and can be complex, and some forum drivers have specific quirks detailed in the nuances tutorial.
Question What are the implications of using the "none-forum" driver?
Answer Using the "none-forum" driver disables or limits many Composr features, including commenting, points, and user interactions. Consider using Conversr instead and restricting access to the forum zone, join module, and personal zone.
Question How can I integrate my forum visually into my website?
Answer Composr allows you to integrate your forum visually into your website. Enable "Show forum within website" in the Admin Zone configuration module and update the forum link in your menu to pass through the "forums" embedding module. You may need to adjust CSS to achieve a seamless look.