Sector(s)

Team Members

Project Team

CodeLift, a Drupal migration specialist, handled the complete Drupal 7 to 10 migration including media entity conversion, theme rebuild from PHP to Twig, research library preservation, forum migration, Pantheon deployment, and ongoing maintenance under an always-up-to-date SLA.

Visit the site

Visit the site

Organizations Involved

Community contributions

config_uuid_deterministic -- A Drupal module for deterministic UUID generation in configuration management, useful for multi-instance deployments and CI/CD pipelines.
ORCA, managed by Paleocultural Research Group, serves as a vital digital repository for Colorado's archaeological and historic preservation community. CodeLift migrated the legacy Drupal 7 site to Drupal 10, converting file attachments to modern media entities, rebuilding the custom theme in Twig, and preserving the comprehensive research library with all its specialized taxonomy and search functionality.

About the project

ORCA (Online Resources for Colorado Archaeology) serves as a vital digital repository for Colorado's archaeological and historic preservation community. Managed by Paleocultural Research Group, the platform provides researchers, educators, and the public with access to archaeological resources, research libraries, and professional forums.

The Challenge:
ORCA faced a critical challenge common to academic and research institutions: their Drupal 7 platform, while functional, was approaching end-of-life with no further security updates. The site housed irreplaceable archaeological research data, including a comprehensive PDF research library with complex metadata, geographic and thematic taxonomies, and an active professional community forum. Any migration had to preserve this scholarly resource completely while modernizing the underlying technology.

Files to Media Entity Conversion:
Legacy file attachments across the research library and resource content types were converted to Drupal's modern Media entity system. This included 3 media types -- document, image, and private document -- with proper access controls for professional-only content. The conversion ensures better management, reusability, and preservation of historical photographs, maps, and documents that form the backbone of archaeological research.

PHP Theme to Twig Conversion:
The original Artisteer-generated PHP theme was completely rebuilt using Drupal's Twig templating engine. Over 17 custom templates were created to maintain the site's distinctive look while enabling modern responsive behavior.

Research Library Preservation:
The PDF Research Library with its complex field structure -- including document types, project types, temporal keywords, thematic keywords, and publication metadata -- was fully migrated with all searchable facets intact. This library represents decades of scholarly work that, once lost, would be irreplaceable.

Specialized Content Architecture:
The migration preserved ORCA's specialized content architecture designed for archaeological research:
- Resource -- General archaeological resources with geographic and thematic categorization, downloadable files, and external links
- PDFResearchLib -- Comprehensive research library entries with citation information, document types, project classifications, temporal/thematic keywords, and professional-only access controls
- Forum -- Active community discussion spaces for professional archaeologists with full threading and notification systems
- Basic Pages -- Informational content about Colorado archaeology and historic preservation

Taxonomy Structure Migration:
Five taxonomy vocabularies essential for resource categorization were preserved. Geographic, thematic, and content-type taxonomies power the site's ability to organize archaeological resources by location, topic, and format.

Forum Community Preservation:
The professional archaeology forum, essential for community discussion, was migrated with all threading, user relationships, and comment notification systems preserved for continued scholarly collaboration.

Migration by the Numbers:
- 360+ configuration files migrated
- 17+ custom Twig templates created
- 3 media types configured (document, image, private)
- 5 taxonomy vocabularies preserved
- 22 Views configurations migrated
- Multi-facet research library search retained

Infrastructure:
The upgraded site was deployed to Pantheon's managed hosting platform with proper CI/CD workflows, Drush integration, and configuration management for ongoing maintenance.

Client Testimonial:
"Niels and his team made this potentially stressful process simple and seamless. They explained every step of the process, were very knowledgeable, professional, and accommodated an 8-hour time difference when we needed to discuss things. The site was accessible the entire time and the site looks and functions exactly like the older Drupal version. We highly recommend working with Niels and the team at CodeLift." -- Paleocultural Research Group

Ongoing Maintenance:
ORCA operates under CodeLift's "Always on the Latest Version" service level agreement. This ensures the platform receives continuous security updates, core upgrades, and module maintenance -- critical for an academic resource serving the archaeology community.

Why Drupal was chosen

The client was already running on Drupal and chose to modernize their platform rather than replatform. Upgrading preserved their existing content, workflows, and team expertise while gaining access to modern Drupal's improved security, performance, and extensibility.
ORCA (Online Resources for Colorado Archaeology)

Technical Specifications

Drupal version:

Key modules/theme/distribution used:

Why these modules/theme/distribution were chosen
The Media module replaced legacy file attachments with modern media entities, enabling better management and access controls for professional-only content. Views powers the 22 listing and search configurations essential for the research library. Forum preserves the professional archaeology community discussion space. Search API provides the multi-facet search capabilities required for navigating the research library by document type, geographic region, temporal period, and thematic keyword.