{"id":29150196,"url":"https://github.com/humanmade/mercator","last_synced_at":"2025-06-30T23:09:48.747Z","repository":{"id":20374477,"uuid":"23649932","full_name":"humanmade/Mercator","owner":"humanmade","description":"WordPress multisite domain mapping for the modern era.","archived":false,"fork":false,"pushed_at":"2024-12-06T11:31:05.000Z","size":176,"stargazers_count":522,"open_issues_count":42,"forks_count":65,"subscribers_count":71,"default_branch":"master","last_synced_at":"2025-06-30T16:14:52.993Z","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":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/humanmade.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2014-09-04T05:40:50.000Z","updated_at":"2025-06-06T16:59:05.000Z","dependencies_parsed_at":"2022-07-21T07:48:05.484Z","dependency_job_id":"698e2af3-d8ca-489b-a859-1bdd5e28eac0","html_url":"https://github.com/humanmade/Mercator","commit_stats":{"total_commits":137,"total_committers":16,"mean_commits":8.5625,"dds":"0.43065693430656937","last_synced_commit":"9240e7cce9882a9fe452ced8a5cf7845d60c5a2e"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/humanmade/Mercator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanmade%2FMercator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanmade%2FMercator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanmade%2FMercator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanmade%2FMercator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/humanmade","download_url":"https://codeload.github.com/humanmade/Mercator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanmade%2FMercator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262864258,"owners_count":23376461,"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-30T23:09:47.978Z","updated_at":"2025-06-30T23:09:48.703Z","avatar_url":"https://github.com/humanmade.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ctable width=\"100%\"\u003e\n\t\u003ctr\u003e\n\t\t\u003ctd align=\"left\" width=\"70\"\u003e\n\t\t\t\u003cstrong\u003eMercator\u003c/strong\u003e\u003cbr /\u003e\n\t\t\tWordPress multisite domain mapping for the modern era.\n\t\t\u003c/td\u003e\n\t\t\u003ctd align=\"right\" width=\"20%\"\u003e\n\t\t\t\u003ca href=\"https://travis-ci.org/humanmade/Mercator\"\u003e\n\t\t\t\t\u003cimg src=\"https://travis-ci.org/humanmade/Mercator.svg?branch=master\" alt=\"Build status\"\u003e\n\t\t\t\u003c/a\u003e\n\t\t\t\u003ca href=\"http://codecov.io/github/humanmade/Mercator?branch=master\"\u003e\n\t\t\t\t\u003cimg src=\"http://codecov.io/github/humanmade/Mercator/coverage.svg?branch=master\" alt=\"Coverage via codecov.io\" /\u003e\n\t\t\t\u003c/a\u003e\n\t\t\u003c/td\u003e\n\t\u003c/tr\u003e\n\t\u003ctr\u003e\n\t\t\u003ctd\u003e\n\t\t\tA \u003cstrong\u003e\u003ca href=\"https://hmn.md/\"\u003eHuman Made\u003c/a\u003e\u003c/strong\u003e project. Maintained by @rmccue.\n\t\t\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\n\t\t\t\u003cimg src=\"https://hmn.md/content/themes/hmnmd/assets/images/hm-logo.svg\" width=\"100\" /\u003e\n\t\t\u003c/td\u003e\n\t\u003c/tr\u003e\n\u003c/table\u003e\n\nMercator is a domain mapping plugin for the New World. Using new features\nincluded with WordPress 3.9 and later, Mercator builds on the new multisite\nfeatures and abilities to improve your world.\n\nStop using outdated practices, and start making sense.\n\n## Requirements\nMercator requires WordPress 3.9 or newer for the new sunrise processes. Mercator\nalso requires PHP 5.3+ due to the use of namespaced code.\n\n## What is Domain Mapping?\nWhen setting up a Multisite install, the network is configured to create sites either as subdomains of the root site (e.g. `subsite.network.com`) or subfolders (e.g. `network.com/subsite`).\n\nDomain Mapping is the process of mapping any arbitrary domain (called an alias) to load a site. If an alias of `arbitrarydomain.com` is set for the site `network.com/subsite`, the site and wp-admin interface can be accessed over either the alias or the original URL.\n\nInternally, Mercator looks at a request's domain and informs WordPress [what set of tables to use](https://www.youtube.com/watch?t=249\u0026v=3evwb1SiaBY#t=5m42s). User authentication cookies are set for all domains in the network, so a user logs in on one site and is authenticated across all.\n\n## Installation\nMercator must be loaded during sunrise.\n\nWe recommend dropping Mercator's directory into your `mu-plugins` directory. You may need to rename the folder from `Mercator-master` to `mercator`.\n\nThen create a `wp-content/sunrise.php` file with the following:\n\n```php\n\u003c?php\n// Default mu-plugins directory if you haven't set it\ndefined( 'WPMU_PLUGIN_DIR' ) or define( 'WPMU_PLUGIN_DIR', WP_CONTENT_DIR . '/mu-plugins' );\n\nrequire WPMU_PLUGIN_DIR . '/mercator/mercator.php';\n\n```\n\nAdditionally, in order for `sunrise.php` to be loaded, you must add the following to your `wp-config.php`:\n\n```\ndefine('SUNRISE', true);\n```\n\nAliases are created in the Network Admin \u003e Sites \u003e Edit Site screen.\n\nDNS for mapped domains must be configured for the domain to point to the WordPress\ninstallation, as well as configuring the web server to route requests for the\ndomain to the WordPress application.\n\n## Upgrading from WPMU Domain Mapping\nThis plugin is a complete replacement for WPMU Domain Mapping. The database\nstructure is fully compatible.\n\nNote that if you have Domain Mapping code in your sunrise, you should remove\nthis and replace it with the recommended sunrise code above. Mercator hooks in\nto WordPress' internal site mapping code rather than replacing it, unlike Domain\nMapping.\n\n## License\nMercator is licensed under the GPLv2 or later.\n\n## Credits\nCreated by Human Made for high volume and large-scale sites, such as [Happytables](http://happytables.com/). We run Mercator on sites with millions of monthly page views, and thousands of sites.\n\nWritten and maintained by [Ryan McCue](https://github.com/rmccue). Thanks to all our [contributors](https://github.com/humanmade/Mercator/graphs/contributors).\n\nMercator builds on concepts from [WPMU Domain Mapping][], written by Donncha O'Caoimh, Ron Rennick, and contributors.\n\nMercator relies on WordPress core, building on core functionality added in [WP27003][]. Thanks to all involved in the overhaul, including Andrew Nacin and Jeremy Felt.\n\n[WPMU Domain Mapping]: http://wordpress.org/plugins/wordpress-mu-domain-mapping/\n[WP27003]: https://core.trac.wordpress.org/ticket/27003\n\nInterested in joining in on the fun? [Join us, and become human!](https://hmn.md/is/hiring/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhumanmade%2Fmercator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhumanmade%2Fmercator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhumanmade%2Fmercator/lists"}