PHPackages united-philanthropy-forum/km-starter-kit - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. united-philanthropy-forum/km-starter-kit ActiveProject[Utility & Helpers](/categories/utility) united-philanthropy-forum/km-starter-kit ======================================== Knowledge Management Collaborative template for Drupal 8 v3.2.0(9mo ago)03.0k1[4 issues](https://github.com/United-Philanthropy-Forum/km-starter-kit/issues)GPL-2.0-or-laterPHP Since Jan 17Pushed 8mo ago14 watchersCompare [ Source](https://github.com/United-Philanthropy-Forum/km-starter-kit)[ Packagist](https://packagist.org/packages/united-philanthropy-forum/km-starter-kit)[ Docs](https://github.com/united-philanthropy-forum/km-starter-kit)[ RSS](/packages/united-philanthropy-forum-km-starter-kit/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (6)Dependencies (5)Versions (46)Used By (0) KM Starter Kit ============== [](#km-starter-kit) This is the minimalist wrapper around the bulk of the KM Collaborative work done at This code should only need to be referenced when you spin up a new Forum site. ### Requirements: [](#requirements) Building this project successfully requires a few things: 1. The ability to push code to github, specifically, [this repo](https://github.com/United-Philanthropy-Forum/km-collaborative) Make sure you’ve [added an SSH key to your profile on github](https://www.inmotionhosting.com/support/website/git/how-to-add-ssh-keys-to-your-github-account/), and that you are a collaborator or team member with Write permissions on [the KM Collaborative repo](https://github.com/United-Philanthropy-Forum/km-collaborative). This is working when you can visit the [repo home page](https://github.com/United-Philanthropy-Forum/km-collaborative), and see a little pencil in the top-right corner of the README.md file. That means you can edit that file. **If you don't have access**, one of the [United-Philanthropy-Forum owners](https://github.com/orgs/United-Philanthropy-Forum/people) will need to invite you. 2. The ability to create a new repository in the United Philanthropy Forum namespace. You’ll know this is working when you can visit this url without error: **If you don't have access**, one of the [United-Philanthropy-Forum owners](https://github.com/orgs/United-Philanthropy-Forum/people) will need to invite you. 3. Access to Pantheon. You'll know this is working when you can go to [Create a new site in Pantheon](https://dashboard.pantheon.io/sites/create) and be able to choose United Philanthropy Forum from the dropdown. **If you don't have access**, one of the [United Philanthropy Forum Administrators](https://dashboard.pantheon.io/organizations/e8f1697b-fb5c-497c-88f1-5b8eaa98f48e#people) will need to invite you. 4. Access to [the United Philanthropy Forum CircleCI instance](https://circleci.com/gh/United-Philanthropy-Forum). You'll know this is working when you can visit that url. **If you don't have access**, you might need to authenticate Circle -- you can log in with Github. 5. [Composer > 2.0.0](https://getcomposer.org/) Globally available. You'll know this is working when you can type `composer --version` into your console and see something like "Composer version 2.1.6 2021-08-19 17:11:08" 6. [Terminus > 3.6](https://pantheon.io/docs/terminus/install). You'll know this is working when you can type `terminus --version` into your console and see something like `Terminus 3.6.0`. It's a good idea to update Terminus to the *latest* version before running this script, otherwise it may fail inexplicably. 7. [The Pantheon Build tools](https://github.com/pantheon-systems/terminus-build-tools-plugin/#installation). You'll know this is working when you can type `terminus build:project:create -h` into your console and see information about the build:project:create command, like this: ``` Usage: build:project:create [options] [--] [] ... ``` 8. You have run the [One time setup steps](https://github.com/United-Philanthropy-Forum/km-starter-kit/wiki/How-to-test-changes-to-this-starter-kit#one-time) 9. Your local machine is running php 8.3. You'll know this is working when you can type `php -v` into your console and see something like `PHP 8.3.16 (cli)` ### Usage: [](#usage) Choose a new project name To start a new project: - decide on a new project name -- it should be a url-safe string, so letters, dashes, and numbers. It is preferable for the name to match the default domain, so if your domain is "coolfoundation.org" the ideal name is "coolfoundation". - confirm which Pantheon "Team" to build the site under (This is a unique name string, but it can include spaces -- visible in Pantheon under "Team") - confirm which Github Organization the development repository will live under (this is also a URL-safe string, visible in github) For example, to create a site with the project for the ThinkShout Foundation: Project name: thinkshout-foundation Pantheon Team: United Philanthropy Forum Github Org: United-Philanthropy-Forum Be prepared for this command to take 30 minutes. That means making sure your computer doesn't go to sleep in that time. If you're experiencing timeouts, you might try adding a ["ServerAliveInterval"](https://unix.stackexchange.com/a/2013) to keep Pantheon connected to your machine during install. You would run this command: ``` terminus build:project:create --team='United Philanthropy Forum' --org='United-Philanthropy-Forum' --visibility='private' united-philanthropy-forum/km-starter-kit thinkshout-foundation ``` The first time running this command, you will be asked to provide some API keys on Circle and Pantheon. Each step provides links and instructions on doing that. You will also be asked to set a User 1 password for the new site. (If the password request keeps repeating, the system is rejecting your password as insufficiently secure. Choose something more complex.) This will create a new repository in the United Philanthropy Forum github repo, as well as a new Pantheon site: The Pantheon site should also have the km\_collaborative profile installed. Configuring for the global context ---------------------------------- [](#configuring-for-the-global-context) We now have a site who's deployment process is tied to your personal Github account. We don't want this! Change this to the use the UPF CI bot account: - Log in to Github as `upf-ci-bot` (login info in the 1password vault for Forum) - Log in to CircleCI using the Github login for the ci bot. - Visit `https://app.circleci.com/settings/project/github/United-Philanthropy-Forum/MYSITE/environment-variables`, delete these environment variables if present: `GITHUB_EMAIL` `GITHUB_TOKEN` `TERMINUS_TOKEN` (they will now be provided by the org context) - At `https://app.circleci.com/settings/project/github/United-Philanthropy-Forum/MYSITE/ssh`: - Delete the existing "Deploy Key" and then add a new one. - Scroll down to the Additional SSH Keys area, and delete the existing key for the domain "drush.in". Add the SSH private key for the Forum CI Automation Account (attached as a file to the details in 1password) with the domain "drush.in". Initial site setup ------------------ [](#initial-site-setup) If the above process completes successfully, you'll have a github repo and a Pantheon repo tied together with CircleCI, all in the appropriate Organizations or accounts. On Pantheon, you'll have a basic site installed on "dev", but it won't look like much, and it won't have most of the KMC features yet. In order to get these, you'll need to work around Pantheon's memory limits. The best way to do this is to create a local copy of the site and clone down the Pantheon database. In your local environment, disable your PHP memory limits (or set them very high). Then, enable the "kmc\_config\_part2" module. Once you have done so, export your database and import it on Pantheon. You may also want to enable some other kmc submodules, depending on your site requirements, like kmc\_salesforce if you are integrating with a Salesforce instance using the KMC package. These can all be enabled directly on Pantheon once you have "kmc\_config\_part2" enabled -- that is the only module that needs excessive memory to install. ### What to do if the build:project command fails: [](#what-to-do-if-the-buildproject-command-fails) If the `build:project:create` command fails on Pantheon when running `composer create-project` with `Fatal error: Allowed memory size ... exhausted`, then the base install of the distro has become too large (this happens regularly). When it fails this way, you will end up with a broken setup. The only way to fix this is to delete the Pantheon site and Github repo and start again. The most common error is on Drupal installation, getting an out of memory error. To work around this, create a new release of this project, specificying the "minimal" installation profiler rather than km\_collaborative in composer.json script for "install-cms". This will skip the bigger KMC installation process. Once this succeeds, you'll need to run the proper profile installation on a local instance of the site and upload your database to the Pantheon Dev site. If the command fails because of a composer conflict, you can try to debug this by running the simpler build command locally: ``` composer create-project united-philanthropy-forum/km-starter-kit thinkshout-foundation ``` If that fails as well, this repo needs to be updated. If the build:project command fails for some reason, part of the skeleton for the new site might already exist. If it does, delete both the Pantheon environment and the github repo created, if either exist. There is a lot of information about the build tools, which might help with debugging, in [The Pantheon Build tools README](https://github.com/pantheon-systems/terminus-build-tools-plugin). Pantheon also provides [thorough documentation](https://pantheon.io/docs/guides/build-tools) on the full scope of their build tools. ### How to delete a project made with this starter kit. [](#how-to-delete-a-project-made-with-this-starter-kit) [The Pantheon Build tools](https://github.com/pantheon-systems/terminus-build-tools-plugin) provides an [build:env:obliterate](https://github.com/pantheon-systems/terminus-build-tools-plugin#buildenvobliterate) command to delete a site that was spun up using the `build:project:create` command. It will delete both the Pantheon site and the repo, so any changes you've made either place will be lost forever. Example: ``` terminus build:env:obliterate thinkshout-foundation ``` ### Maintaining this project [](#maintaining-this-project) There are minimal files in this project, as it's meant to solely ease the handoff between [The Pantheon Build tools](https://github.com/pantheon-systems/terminus-build-tools-plugin) and the [KM Collaboration profile](https://github.com/United-Philanthropy-Forum/km-collaborative). So when an upstream change happens in the [the D8 pantheon drop](https://github.com/pantheon-systems/example-drops-8-composer), the following update rules can be used to update this repo as well: #### .gitignore [](#gitignore) This code belongs in this project only. It should only need to be updated if you need to add another file to this repo. #### README.md [](#readmemd) This code belongs in this project only. It should only need to be updated if changes are made to the process or requirements. #### composer.json [](#composerjson) This code was largely taken from [the D8 pantheon drop](https://github.com/pantheon-systems/example-drops-8-composer), but has been customized to the point where it is too different to be worth parsing. #### scripts/composer/ScriptHandler.php [](#scriptscomposerscripthandlerphp) This is a direct copy of the same file in [the D8 pantheon drop](https://github.com/pantheon-systems/example-drops-8-composer) and will be overwritten by upstream changes on in the [km-collaborative profile](https://github.com/United-Philanthropy-Forum/km-collaborative). This file needs to exist in this repo for the terminus build command to succeed, and it can be pulled from the drop to this repo directly at any time. #### scripts/composer/ScriptUpdater.php [](#scriptscomposerscriptupdaterphp) This code lives in this repository and is maintained in the [km-collaborative profile](https://github.com/United-Philanthropy-Forum/km-collaborative). It is very much like the [drupal scaffolding](https://github.com/drupal/core-composer-scaffold) functionality in that it pulls files from another repo directly and overwrites them on composer install. Unlike the drupal-scaffold plugin, though, this script does not require you to declare every file you wish to pull from the child package to the site package. ### Health Score 44 — FairBetter than 92% of packages Maintenance59 Moderate activity, may be stable Popularity19 Limited adoption so far Community17 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 50.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~101 days Recently: every ~221 days Total 21 Last Release 272d ago Major Versions v0.5.6 → v1.0.02021-09-24 v1.1.1 → v2.x-dev2022-09-08 v2.0.0 → v3.0.02024-02-19 PHP version history (2 changes)v0.2PHP >=7.0.8 v2.0.0PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/4fbf7d93f5644aeefef1fe134e6fc6b11f4abc69670a7857e50d14eafb23c6e8?d=identicon)[mariacha](/maintainers/mariacha) --- Top Contributors [![unclegcb](https://avatars.githubusercontent.com/u/2730679?v=4)](https://github.com/unclegcb "unclegcb (62 commits)")[![mariacha](https://avatars.githubusercontent.com/u/999525?v=4)](https://github.com/mariacha "mariacha (30 commits)")[![wxactly](https://avatars.githubusercontent.com/u/1130929?v=4)](https://github.com/wxactly "wxactly (18 commits)")[![maria-thinkshout](https://avatars.githubusercontent.com/u/50145226?v=4)](https://github.com/maria-thinkshout "maria-thinkshout (12 commits)")[![aaronbauman](https://avatars.githubusercontent.com/u/508451?v=4)](https://github.com/aaronbauman "aaronbauman (1 commits)") ### Embed Badge ![Health badge](/badges/united-philanthropy-forum-km-starter-kit/health.svg) ``` [![Health](https://phpackages.com/badges/united-philanthropy-forum-km-starter-kit/health.svg)](https://phpackages.com/packages/united-philanthropy-forum-km-starter-kit) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)