{"id":16060790,"url":"https://github.com/geerlingguy/jeffgeerling-com","last_synced_at":"2025-03-15T10:30:52.783Z","repository":{"id":41553204,"uuid":"238247606","full_name":"geerlingguy/jeffgeerling-com","owner":"geerlingguy","description":"Drupal Codebase for JeffGeerling.com","archived":false,"fork":false,"pushed_at":"2025-01-09T05:25:29.000Z","size":1422,"stargazers_count":55,"open_issues_count":20,"forks_count":3,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-02-27T00:04:32.279Z","etag":null,"topics":["drupal","jeff-geerling","migration","personal","website"],"latest_commit_sha":null,"homepage":"https://www.jeffgeerling.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geerlingguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"geerlingguy","patreon":"geerlingguy"}},"created_at":"2020-02-04T16:08:34.000Z","updated_at":"2025-01-19T03:59:08.000Z","dependencies_parsed_at":"2023-02-15T14:16:10.193Z","dependency_job_id":"10779117-8e9a-467c-aa4d-a91fd5ffa33f","html_url":"https://github.com/geerlingguy/jeffgeerling-com","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fjeffgeerling-com","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fjeffgeerling-com/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fjeffgeerling-com/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fjeffgeerling-com/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geerlingguy","download_url":"https://codeload.github.com/geerlingguy/jeffgeerling-com/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243718767,"owners_count":20336589,"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":["drupal","jeff-geerling","migration","personal","website"],"created_at":"2024-10-09T04:06:24.911Z","updated_at":"2025-03-15T10:30:52.776Z","avatar_url":"https://github.com/geerlingguy.png","language":"PHP","funding_links":["https://github.com/sponsors/geerlingguy","https://patreon.com/geerlingguy","https://www.patreon.com/geerlingguy"],"categories":[],"sub_categories":[],"readme":"# JeffGeerling.com Drupal Codebase\n\n[![CI](https://github.com/geerlingguy/jeffgeerling-com/workflows/CI/badge.svg?branch=master\u0026event=push)](https://github.com/geerlingguy/jeffgeerling-com/actions?query=workflow%3ACI)\n\nThis is the Drupal codebase that powers [JeffGeerling.com](https://www.jeffgeerling.com).\n\nThe building of this project and the migration of JeffGeerling.com from Drupal 7 to Drupal 8 has been live-streamed on geerlingguy's YouTube channel; you can watch all the episodes and see episode summaries and resources here: [Migrating JeffGeerling.com from Drupal 7 to Drupal 8 - How-to video series](https://www.jeffgeerling.com/blog/2020/migrating-jeffgeerlingcom-drupal-7-drupal-8-how-video-series).\n\nI decided to open-source my website's codebase to help other Drupal users see how I built and maintain this site. If you like what you see or have been helped in any way by this project, please consider supporting me via [Patreon](https://www.patreon.com/geerlingguy), [GitHub Sponsors](https://github.com/sponsors/geerlingguy), or another [affiliate link](https://www.jeffgeerling.com/affiliates).\n\n## Deploying to Production\n\nCurrently the process for deploying runs from the Midwestern Mac infrastructure playbook:\n\n    ansible-playbook main.yml --tags=deploy\n\n### Docker in Production\n\nThis repository includes a `Dockerfile.prod` intended for building a production-ready image (with all code and assets included).\n\nTo build that image:\n\n    docker build -f Dockerfile.prod -t geerlingguy/jeffgeerling-com:arm64 .\n\nThen you can push the image to the official [`geerlingguy/jeffgeerling-com`](https://hub.docker.com/r/geerlingguy/jeffgeerling-com) repository on Docker Hub:\n\n    docker push geerlingguy/jeffgeerling-com:arm64\n\n\u003e Note: The image is automatically built and pushed to Docker Hub via GitHub Actions every time a commit is pushed to the `master` branch.\n\n## Local Environment\n\nThe first time you start using this project, you need to create your local settings file:\n\n    cp web/sites/default/example.settings.local.php web/sites/default/settings.local.php\n\nMake sure you have Docker installed, then run the following command (in the same directory as this README file):\n\n    docker compose up -d\n\nInstall PHP dependencies running Composer inside the container:\n\n    docker compose exec drupal composer install\n\nVisit http://localhost/ to see the Drupal installation. Visit http://localhost:8025/ to see MailHog.\n\n### Installing Drupal\n\nYou can install Drupal using the install wizard, but we like to use Drush for more automation:\n\n    docker compose exec drupal bash -c 'vendor/bin/drush site:install minimal --db-url=\"mysql://drupal:$DRUPAL_DATABASE_PASSWORD@$DRUPAL_DATABASE_HOST/drupal\" --site-name=\"Jeff Geerling\" --existing-config -y'\n\n### Syncing the Database from Production\n\nAt some point, I'll write up how to do it all with Drush, automated.\n\nFor now:\n\n  1. Open Sequel Ace, download database from prod server.\n  2. Open Sequel Ace, upload database to local environment.\n\n### Updating Configuration\n\nAny time configuration is changed or any modules or Drupal is upgraded, you should export the site's configuration using the command:\n\n    docker compose exec drupal bash -c 'vendor/bin/drush config:export -y'\n\nAnd then push any changes to the Git repository before deploying the latest code to the site.\n\n### Upgrading Core (and Contrib)\n\n  1. Set up the site like normal, make sure it's installed.\n  2. Run `docker compose exec drupal bash -c 'composer update'` (to update everything).\n  3. Run `docker compose exec drupal bash -c 'vendor/bin/drush updb -y'`\n  4. Run `docker compose exec drupal bash -c 'vendor/bin/drush config:export -y'`\n  5. Commit any changes and push to remote.\n  6. Run the deploy playbook to update the live site.\n\n### Linting PHP code against Drupal's Coding Standards\n\nYou can test the custom code in this project using `phpcs`:\n\n    docker compose exec drupal bash -c './vendor/bin/phpcs \\\n      --standard=\"Drupal,DrupalPractice\" -n \\\n      --extensions=\"php,module,inc,install,test,profile,theme\" \\\n      web/themes/jeffgeerling \\\n      web/modules/custom'\n\n### Email Debugging with MailHog\n\nThe Docker configuration for this project enables a [MailHog](https://github.com/mailhog/MailHog) container, which has a web UI available at `http://127.0.0.1:8025`.\n\nThe `php.ini` file for the local environment is automatically configured to use `mhsendmail` to send PHP's email through the mailhog instance when you're using this project's `Dockerfile` to build the Drupal environment.\n\nWhen Drupal sends an email, it should be visible in Mailhog's UI.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Fjeffgeerling-com","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeerlingguy%2Fjeffgeerling-com","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Fjeffgeerling-com/lists"}