Migrating

These FAQs briefly summarise key points on how to migrate content to a Composer site or migrating a Composr site across servers.

For more information, check out these tutorials:
Question How do I move my Composr website to a new server?
Answer Moving a Composr site involves transferring both the files and the database.

Files:
  • On the old server, ZIP the entire Composr directory.
  • Download the ZIP file to your computer.
  • Upload the ZIP file to the new server using SFTP/FTP.
  • On the new server, unzip the file.

Database:
  • On the old server, create an SQL dump of your database using the mysqldump command or phpMyAdmin.
  • Download the SQL dump file.
  • If your URL is changing, search and replace the old URL with the new one in the SQL dump file.
  • Upload the SQL dump file to the new server.
  • Restore the database on the new server using the mysql command or phpMyAdmin.

Important Steps:
  • File Permissions: After transferring files, ensure correct file permissions are set on the new server. You can use the fixperms.php script, the upgrader script, or manually adjust them.
  • Configuration: If database settings are different on the new server, update the _config.php file or use the config_editor.php script to change the settings for both the site and forum databases.
  • Base URL: If your URL has changed, update the base URL setting in the Installation Options editor (config_editor.php).
  • Caches: Clear the block cache using the upgrader.php script.
Question Can I import data from other platforms into Composr?
Answer Yes, Composr offers importers for several popular platforms:
  • Forum Software: Invision Board, MyBB, phpBB, Simple Machine Forum, vBulletin
  • Content Management Systems: WordPress
  • Special Importers: HTML website importer, Composr merge (for merging another Composr site)
Question What data formats can Composr import?
Answer Composr primarily uses database connections for importing. However, it also supports neutral data formats like CSV spreadsheet files and importing downloads from a directory.
Question Where can I find the import functionality in Composr?
Answer Navigate to Admin Zone > Tools > Import.
Question Are there any limitations to importing forum data?
Answer Yes, some limitations exist, particularly with specific forum platforms.
  • General: Private messages are often combined into private topics.
  • phpBB: Usergroup configuration and HTML entities may require manual adjustments after import.
  • vBulletin: Calendar recurrences, ratings (karma), and 'goes to coventry' are not imported perfectly. Attachments may need to be extracted directly from the live database due to potential corruption in SQL dumps.
  • Simple Machine Forum: Banning features may not import perfectly due to differences in how Composr handles bans.
Question What is a Composr import session?
Answer Import sessions track the progress and ID remapping for each import, allowing you to merge multiple sites or resume interrupted imports. This is particularly useful when merging multiple Composr sites into one.
Question How does the HTML website importer work?
Answer The HTML website importer is an advanced tool for migrating static HTML websites to Composr. It analyzes the HTML structure to create zones, Comcode pages, and a basic template. It also attempts to fix links and file paths for Composr compatibility.
Question Can I switch from a third-party forum to Conversr (Composr's built-in forum)?
Answer Yes, if an importer exists for your current forum software, you can switch to Conversr during the import process. Composr will handle the forum driver switch and remap user IDs, but it's recommended to double-check permissions afterward.
Question Where can I get help with the import process?
Answer The Composr documentation provides extensive information. Additionally, you can seek assistance from experienced Composr developers, including the Composr team if your project allows for professional support.
Question What should I do after successfully importing data into Composr?
Answer After importing, if all files like avatars, photos, and attachments have been copied to Composr's directories, you can remove the imported product's directory. However, it's advisable to keep the directory, database, and import session for a few weeks in case any data was not correctly imported and needs further attention. Importing is a complex process, so keeping backups and sources for a while is a good practice.