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 can I communicate privately with other members?
Answer Conversr offers two ways to have private conversations:
  • Private Topics:
    • Start a private topic from a member's profile, by clicking "Whisper" on their post and selecting "Quote post to a new Private Topic with this member," or from your account by selecting "Start a Private Topic" and entering the desired username.
    • Participate in the topic just like a regular forum topic.
    • You will receive notifications for new posts in your private topics.
    • Topics can be moved to the "Trash" category or other categories of your choosing for organization.
  • Inline Personal Posts (Whispers):
    • Send a private message within a public topic by clicking "Whisper" on a post and selecting "In-topic personal post to this member."
    • Whispers are visible only to the sender and recipient, and the whispered post is highlighted.
    • Receive notifications for new whispers.
Question What are some key considerations when choosing field types for my catalogue?
Answer When selecting field types, consider:
  • Data type: Choose the appropriate field type for the data you want to collect (text, numbers, dates, etc.).
  • Comcode support: If you need rich text formatting or translation support, opt for fields that support Comcode.
  • Validation: Some field types offer built-in validation to ensure data accuracy.
  • Privacy implications: Be mindful of the sensitivity of the information and whether it requires specific privacy considerations.
Question How can I ensure the privacy of personal information stored in my catalogues?
Answer Composr's privacy system can help manage personal data within catalogues. To leverage it:
  • Use specific field types: Utilize dedicated field types for sensitive data like member IDs, usernames, emails, IP addresses, and passwords for efficient handling by the privacy system.
  • Enable "May contain personal information": Mark fields that may contain personal information, enabling the privacy system to identify and handle such data during purging or downloading.
Question What are some specialized types of catalogues available in Composr?
Answer Composr supports specialized catalogues, including:
  • eCommerce catalogues: Integrate with the Composr shopping cart for online stores.
  • Classified ads: Offer features like archival categories and usergroup-specific advert durations.
Question How are breadcrumbs handled in catalogue views?
Answer Catalogue breadcrumbs can be customized using XML code (Admin Zone > Structure > Configure breadcrumb overrides). By default, they include the list of catalogues. However, Composr provides default breadcrumb XML that removes this, focusing on the current category hierarchy. Tree catalogues omit the index link, while non-tree catalogues include it.
Question What is a tree catalogue and how do I create one quickly?
Answer A tree catalogue has a hierarchical category structure (which can contain sub-categories), similar to the download system. Composr offers a special feature for creating tree catalogues by simply typing the desired categories in a specific format (which is explained and available when adding a new catalogue), which automatically generates the tree structure.

Alternatively, a non-tree catalogue is simpler and only has top-level categories.
Question Can I customize the look and feel of my catalogue?
Answer Yes, Composr allows advanced users to customize catalogue appearance through Tempcode programming. This involves using template IF directives to apply specific styles based on the catalogue's name and manipulating template parameters for complex layouts. Alternatively, you can create new template files using the catalogue name in the file to specify complete templates for specific catalogues. Check out the tutorials for more information.
Question What are the different display types for catalogue entries?
Answer Composr provides four main display types for catalogue entries:
  • Title lists: Simple lists of entry titles linking to the full entry page.
  • Field-maps: Highly flexible, displaying as many fields as you desire within the category view.
  • Tabular listings: Organizes entries into columns, suitable for short data fields.
  • Grids of images: Displays entries as a grid of images, ideal for visual catalogues.

It is possible to create your own templates including ones that are specific to a catalogue. Check out the catalogues tutorial for more information.
Question Why might I need a programmer for my catalogue?
Answer While Composr catalogues offer great flexibility, they can become complex if you need sophisticated data relationships, efficient searching, high data reliability, or advanced customization. In these cases, a programmer's expertise in database design, normalization, and templating can be invaluable.
Question What are catalogues in Composr?
Answer Catalogues are custom databases you can create within your Composr website. They allow you to define your own records with custom fields and organize them into categories. Think of them as powerful tools for managing various types of content, like a database of books, a directory of businesses, or even a classified ads system.