Understanding Chamilo URL Structure

Chamilo LMS relies heavily on URL parameters to maintain course context throughout a user's session. This design pattern, while flexible, can lead to unexpected behavior when course materials contain references to other courses or when URL rewrites are improperly configured. The core issue manifests when a user accesses a document in one course that contains links or media references to another course. This triggers a context switch, potentially disrupting quiz sessions or causing access errors.

The URL structure typically follows the pattern /courses/{course_id}/document/{file_path}, with additional query parameters specifying session IDs and other context information. When copying courses or migrating content between environments, absolute paths in HTML documents can persist, leading to cross-course references that break functionality.

Course Context Preservation

Chamilo's course context preservation mechanism depends on URL parameters and session variables. When a user accesses a course document that contains embedded references to another course, the system processes these references through separate HTTP requests. Each request updates the session context, potentially causing the user to lose their place in the original course.

For example, consider a scenario where Course B contains an HTML document with an embedded image from Course A. When the user accesses this document, their browser makes two requests:

  1. The initial request for the HTML document sets the context to Course B
  2. The subsequent request for the image from Course A updates the context to Course A

This context switch can disrupt ongoing activities like quizzes or assignments. The issue becomes particularly problematic when users don't have access to the referenced course, as it may prevent them from completing their current task.

URL Rewrite Configuration

To mitigate these issues, proper URL rewrite configuration is essential. Chamilo uses .htaccess files for URL rewriting in Apache environments or equivalent rewrite rules in LiteSpeed. The following configuration demonstrates how to handle course-specific rewrites:

RewriteEngine On

# Course document rewrites
RewriteRule ^courses/([^/]+)/document/(.*)$ /main/document/download.php?doc_url=/$2&cDir=$1 [QSA,L]

# SCORM content rewrites
RewriteRule ^courses/([^/]+)/scorm/(.*)$ /main/document/download_scorm.php?doc_url=/$2&cDir=$1 [QSA,L]

# Course upload rewrites
RewriteRule ^courses/([^/]+)/upload/(.*)$ /app/courses/$1/upload/$2 [QSA,L]

These rules ensure that all course-specific URLs are properly routed through Chamilo's access control mechanisms. The [QSA,L] flags preserve query string parameters and mark these rules as last in the processing chain.

Canonical URLs and SEO

Chamilo implements canonical URLs to prevent duplicate content issues in search engines. The system generates canonical tags based on the canonical_url configuration setting in app/config/configuration.php. Ensure this setting points to your primary domain:

$_configuration['canonical_url'] = 'https://your-chamilo-domain.com';

When configuring canonical URLs, consider these best practices:

  • Use HTTPS for all canonical URLs
  • Maintain consistency across all instance URLs
  • Ensure generated URLs match the canonical base

Proper canonical URL configuration helps search engines understand your content structure and prevents indexing of duplicate course materials across different URLs.