You can import images in bulk using a CSV file. The file should be named descriptions.csv and placed in the uploads/galleries directory. The first column should contain filenames (without the path), and the second column should contain descriptions. The filenames should correspond to images also located in the uploads/galleries directory. Composr will automatically match the descriptions to the images during import.
Composr Galleries are a system for storing, organizing, and displaying images and videos. They function like categories, allowing you to group related media together. Galleries can be structured hierarchically, with sub-galleries nested under parent galleries, similar to a folder system. Each gallery has settings that control its appearance and behavior.
Can I organize Comcode pages in a hierarchical structure?
Answer
Yes, Composr allows you to simulate a hierarchical structure for your Comcode pages using multi-part paths in the page monikers. By editing the page monikers to include slashes (e.g., "about/team"), you can create a virtual directory structure within a single zone, enhancing your site's organization and navigation.
How do I embed content from other modules into a Comcode page?
Answer
You can use various blocks to embed content from different modules:
main_content block: Allows you to feature individual entries from modules/content like news or articles.
main_multi_content, main_cc_embed, main_gallery_embed, main_news blocks: Enable you to pull in and display multiple entries based on categories or other criteria.
main_include_module block: Provides a powerful way to integrate any module screen directly into a Comcode page.
What is the difference between blocks and boxes in Composr?
Answer
While both terms may seem similar, they have distinct meanings in Composr:
Blocks are functional units that generate dynamic content or provide specific features. They don't inherently have a visual form and their output can vary widely.
Boxes are a visual design element in Composr, essentially containers that visually group content on a page and often with a title at the top.
In practice, blocks often place their content within a box, but this isn't a requirement / standard.
Yes, you can customize the appearance of blocks by editing the associated templates and CSS. Each block typically has a corresponding template file (e.g., BLOCK_MAIN_NEWS.tpl for the main_news block) that controls its HTML structure. You can modify this template to change the layout and styling of the block's output.
An easy way to do this is through the template editor in Admin Zone > Style > Themes, and click edit templates for the relevant theme.
Composr utilizes "blocks" to embed dynamic content and functionality within Comcode pages. These blocks can range from displaying recent forum posts to showing information about the logged-in user.
To add a block, you can use the "block construction assistant" accessible via a button above the editor. This tool provides a user-friendly way to:
Browse and select available blocks.
Configure the block parameters.
Preview the block output.
Generate the necessary Comcode to embed the block.
Composr provides two easy ways to create a new Comcode page:
Method 1: Direct URL Entry Type the desired URL of your new page into your browser's address bar. Since the page doesn't exist yet, Composr will present you with a 404 error and a link to create it. Click the link to open the Comcode page editor.
Method 2: Admin Zone Navigate to Admin Zone > Content > Pages (Comcode pages). Scroll down to the list of existing pages and enter the name of your new page using the ":" (page-link) format. For example, a new page in the Welcome zone named "about" would be entered as ":about", or a new page in the "site" zone named "foobar" would be entered as "site:foobar".
Comcode pages are standalone content pages within the Composr system that you can create and edit using either a WYSIWYG editor, a simple markup language called Comcode, or a combination of both.
Think of them as documents within your website, offering flexibility beyond the structured content provided by modules like forums or news. You can use them to build landing pages, about us sections, contact pages, and more.
Yes, you can create custom Comcode tags through the Admin Zone > Setup > Custom Comcode. This allows you to add unique functionality or wrap specific HTML code (especially if you use a certain block of HTML frequently on your site) for easier use. Custom Comcode tags can be tailored to your needs and even include your own parameters. You can also specify if the Comcode is dangerous so only those with elevated privileges can use it.
What are the security considerations when using Comcode?
Answer
Composr has a multi-tiered security system for Comcode. HTML code is filtered based on user permissions to prevent XSS attacks. Content is parsed with different credentials depending on who is editing or adding it, ensuring users can't elevate their privileges by modifying existing content.
oEmbed is a system that allows you to embed content from other websites simply by pasting its URL. When you paste a supported link in Comcode, oEmbed will automatically embed the content for you in a nicely-formatted box. For example, pasting a YouTube video link will embed the video directly into your content so it can be played on your website.
