{"id":28453884,"url":"https://github.com/concretecms/migration_tool","last_synced_at":"2025-06-28T05:31:44.797Z","repository":{"id":46154604,"uuid":"241913939","full_name":"concretecms/migration_tool","owner":"concretecms","description":"Migration tool for Concrete CMS version 9+.","archived":false,"fork":false,"pushed_at":"2025-04-29T02:15:01.000Z","size":2579,"stargazers_count":9,"open_issues_count":20,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-06T18:53:02.836Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/concretecms.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-20T15:06:11.000Z","updated_at":"2025-03-04T19:31:32.000Z","dependencies_parsed_at":"2024-06-14T16:12:55.914Z","dependency_job_id":null,"html_url":"https://github.com/concretecms/migration_tool","commit_stats":{"total_commits":318,"total_committers":13,"mean_commits":24.46153846153846,"dds":"0.14779874213836475","last_synced_commit":"b410891c2ad6173f7b4322bf18e41bbc71d13729"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/concretecms/migration_tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concretecms%2Fmigration_tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concretecms%2Fmigration_tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concretecms%2Fmigration_tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concretecms%2Fmigration_tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/concretecms","download_url":"https://codeload.github.com/concretecms/migration_tool/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/concretecms%2Fmigration_tool/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262381396,"owners_count":23302230,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-06T18:40:07.650Z","updated_at":"2025-06-28T05:31:44.792Z","avatar_url":"https://github.com/concretecms.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Installation\n\n## Download the Correct Package\n\nThere are several versions of the Migration Tool designed to work with\nvarious historical and current versions of Concrete CMS. Navigate to\nthe appropriate GitHub repository page and download the latests release of the master branch:\n\n| Concrete CMS (concrete5) Version | Compatible Migration Tool                                                                   | Branch | Package Directory                                                                                                |\n|----------------------------------|---------------------------------------------------------------------------------------------|--------|------------------------------------------------------------------------------------------------------------------|\n| \u003c=5.6.x (legacy)                 | [Addon Migration Tool (Legacy)](https://github.com/concretecms/addon_migration_tool_legacy) | master | [migration_tool](https://github.com/concretecms/addon_migration_tool_legacy/tree/master/packages/migration_tool) |\n| 5.7x through 8.x                 | [Addon Migration Tool](https://github.com/concretecms/addon_migration_tool)                 | master | [migration_tool](https://github.com/concretecms/addon_migration_tool/tree/master/packages/migration_tool)        |\n| 9.x+                             | [Migration Tool](https://github.com/concretecms/migration_tool)                             | master | [migration_tool](https://github.com/concretecms/migration_tool)                                                  |\n\n## Install the Package on Your Concrete CMS\n\n1. **Upload the package:**\n   - Extract the downloaded ZIP file.\n   - Upload or copy the `migration_tool` directory to your Concrete\n     installations under `packages/` (located in the installation\n     root).\n\n# General Process Note\n\nExporting and importing content is not always a straightforward\nprocess. Differences in the source and destination sites may require\nnew attribute mappings or other compromises. The hurdles and solutions\nare not always obvious from the outset, so unless the two sites are\nexact copies, plan on this being an iterative process. \n\nTo help simplify this process, it may be useful to group exported data\ninto smaller batches of content either by type or by size. The\nimportation of these smaller batches can be verified for accuracy and\ncompleteness and, if issues are found, can be corrected through\ndifferent mappings.\n\nAs part of this process, the destination site might accumulate\nimported content which is not correct. A backup should be made of the\ndestination site before importing any content or, if the site is a\nfresh installation, be prepared to drop the database and start\nover. To simplify the process, content mapping settings can be saved\nand revised until all content is imported correctly. This makes the\nprocess repeatable and facilitates a final import after this\ntrial-and-error process.\n\nMore detailed instructions and advice can be found in the [Migration\nTool\nTutorial](https://documentation.concretecms.org/tutorials/using-concrete-migration-tool-addon).\n\n# Exporting Content\n\nFrom the source site, export the content using the following steps.\n\n## Access the Migration Tool\n\n- After installation, access the Migration Tool by navigating to\n  **Dashboard** \u003e **Migration Tool**.\n\n## Create a New Export Batch\n\n1. **Create Batch:**\n   - Click on **Create New Batch**.\n   - Name your batch for easy identification. Content is often\n     exported in batches rather than all at once especially when there\n     are large differences beteen the source and destination\n     sites. For example, you might export users and associated\n     information as one batch first, and then later export the pages\n     they authored as another batch.\n\n2. **Select Content to Export:**\n   - Choose the content types you wish to export (e.g., pages, files, users).\n   - Configure the specifics for each content type, such as which\n     pages or which user data to include.\n\n## Run the Export\n\n- Once you’ve configured your batch, click **Export** to generate a\n  XML file containing your selected content.\n- Download this file to your local machine. It will be used to import\n  content to the destination site.\n\n# Importing Content\n\n## Upload the Export File\n\n- Navigate to **Dashboard** \u003e **Migration Tool** on the destination site.\n- Click on **Import Content**.\n\n## Start the Import Process\n\n1. **Upload the XML File:**\n   - Use the file upload interface to select and upload the XML file\n     you exported from the source site.\n\n2. **Import Content:**\n   - After the file is uploaded, the tool will automatically parse the XML.\n   - Review the content and configurations to be imported. Map the\n     content where needed. This is where breaking the exported content\n     into batches as this process can be labor intensive. \n     - Once all content is mapped, consider saving the mapping\n       settings. This can help save time if the import process does\n       not work as expected. \n   - Click **Perform Import** to begin the import process.\n\n## Verify the Imported Content\n\n- After the import process completes, verify that all content has been\n  successfully imported and is functioning as expected. You may have\n  to try importing the content with different settings or mappings and\n  check the results for completeness.\n- Check for any discrepancies or issues and address them as\n  necessary. If you have saved the content mappings, this\n  trial-and-error process will be much easier.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconcretecms%2Fmigration_tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconcretecms%2Fmigration_tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconcretecms%2Fmigration_tool/lists"}