{"id":16904467,"url":"https://github.com/crell/planedobundle","last_synced_at":"2025-08-18T11:33:36.279Z","repository":{"id":44135895,"uuid":"451585926","full_name":"Crell/PlanedoBundle","owner":"Crell","description":"Feed aggregator bundle for Symfony 5.4 and later.","archived":false,"fork":false,"pushed_at":"2024-05-11T14:51:33.000Z","size":329,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-25T10:42:38.948Z","etag":null,"topics":["atom","blog","feed","php","rss"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Crell.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["Crell"]}},"created_at":"2022-01-24T18:31:45.000Z","updated_at":"2024-05-11T14:51:36.000Z","dependencies_parsed_at":"2025-02-19T15:49:42.851Z","dependency_job_id":null,"html_url":"https://github.com/Crell/PlanedoBundle","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":"Crell/php-project-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crell%2FPlanedoBundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crell%2FPlanedoBundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crell%2FPlanedoBundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crell%2FPlanedoBundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Crell","download_url":"https://codeload.github.com/Crell/PlanedoBundle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248419776,"owners_count":21100251,"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":["atom","blog","feed","php","rss"],"created_at":"2024-10-13T18:33:30.833Z","updated_at":"2025-04-11T14:33:02.147Z","avatar_url":"https://github.com/Crell.png","language":"PHP","funding_links":["https://github.com/sponsors/Crell"],"categories":[],"sub_categories":[],"readme":"# Planedo Bundle\n\n[![Latest Version on Packagist][ico-version]][link-packagist]\n[![Software License][ico-license]](LICENSE.md)\n[![Total Downloads][ico-downloads]][link-downloads]\n\nPlanedo is a blog aggregator bundle for Symfony 6.  It aims to be a mostly out-of-the-box setup for a Planet-style blog aggregator, or as close to that as Bundles allow anyway.\n\n\"Planedo\" is Esperanto for \"Planet,\" as in blog-aggregator \"planet.\"\n\n## Installation\n\nThere are two ways to set up Planedo Bundle.\n\nIf you want to just use Planedo as a stand-alone application and be done with it, install the Planedo application.\n\n```shell\ncomposer project-create crell/planedo\n```\n\nThat will create a new project pre-configured to use with Planedo.  Nearly all meaningful functionality is in the bundle, so you can modify the application itself to your heart's content.  Future updates to Planedo itself will come via updating the bundle through Composer.\n\nAlternatively, you may install Planedo Bundle directly in Symfony 5.4/6 application of your choice, via composer.\n\n```shell\ncomposer require crell/planedo-bundle\n```\n\nIf you take this approach, there are a few manual steps necessary to wire the bundle into the application.\n\n### Add a dev-dependency\n\nAt this time, Planedo uses the pre-release version of PSR-20 from the PHP-FIG.  It is not yet on Packagist, so you will need to include the following in your main application's `composer.json`:\n\n```json\n{\n  \"repositories\": [\n    {\n      \"type\": \"git\",\n      \"url\": \"https://github.com/php-fig/clock.git\"\n    }\n  ]\n}\n```\n\nThat will allow Composer to download the appropriate package.  This step will be unnecessary once PSR-20 is released.\n\n### Enable the bundle\n\nAdd the bundle to your `bundles.php` file:\n\n```php\nCrell\\Bundle\\Planedo\\PlanedoBundle::class =\u003e ['all' =\u003e true],\n```\n\n### Routing\n\nCreate a new file named `config/routes/planedo.yaml` and give it the following content:\n\n```yaml\n# config/routes/planedo.yaml\n\nplanedo_admin:\n    resource: '@PlanedoBundle/config/routes_admin.yaml'\n    prefix: ''\n\nplanedo_public:\n    resource: '@PlanedoBundle/config/routes_public.yaml'\n    prefix: ''\n```\n\nThe above setup assumes that you want Planedo's routes to be at the root of your site.  If not, add a `prefix` for either the front-end or admin routes as you prefer.\n\n### User and password management\n\nPlanedo provides its own user accounts and password handling.  A mechanism to disable is coming soon.\n\nYou may also choose to ignore the provided user system and use your own.  In that case, ensure that users who should have access to the Planedo administrative area are given the `ROLE_ADMIN` role.  How you end up doing that is up to you.\n\n## Configuration\n\nPlanedo includes its own minimal configuration in `config/planedo.yaml`.  There are three configuration options, all optional.  The defaults should be reasonable for most circumstances.\n\n* `items_per_page` (default 10): This integer specifies how many feed entries will be shown per page on HTML lists, and will be shown total in RSS and Atom feeds.\n* `purge_before` (default `-30 days`): Every time the purge cron job runs, any entries dated older than this will be deleted.  Entries older than this will also not be imported.  You may use any string that is valid according to PHP's [relative date format](https://www.php.net/manual/en/datetime.formats.relative.php).\n* `use_plain_text` (default false): If set to true, RSS and Atom feeds will use a `text/plain` mime type instead of their appropriate XML mime type.  This is mainly useful for debugging and can be ignored 99% of the time.\n\nFor example:\n\n```yaml\n# config/planedo.yaml\n\nplanedo:\n    items_per_page: 20\n    purge_before: -60 days\n```\n\n## Initial setup\n\nOnce Planedo is set up, you will need to create the first admin user.  A CLI command is provided for that purpose.\n\n```shell\nbin/console planedo:create-user --email you@example.com\n```\n\nYou will be prompted for a password, or you may provide one on the command line.  See the command's help text for more details.\n\nYou may now go to `\u003cplanedo admin prefix\u003e/admin` to login, then start adding feeds.\n\n## Setting up cron tasks\n\nRegardless of how you run Planedo, you will need to setup two cron tasks through the cron runner of your choice.  How often you run them is up to you, but at least daily is recommended.\n\nThe first update refetches feeds to get new entries:\n\n```shell\nbin/console planedo:update-all\n```\n\nThe second update deletes old entries (where \"old\" is defined by the `purge_before` configuration setting):\n\n```shell\nbin/console planedo:purge-old\n```\n\n## Queues\n\nPlanedo runs most tasks through Symfony's Message Bus system.  That allows it to be deferred to a queue.  While not required, it is *strongly recommended* that you wire the following messages to an async backend:\n\n* `Crell\\Bundle\\Planedo\\Message\\ApproveEntries`\n* `Crell\\Bundle\\Planedo\\Message\\PurgeOldEntries`\n* `Crell\\Bundle\\Planedo\\Message\\RejectEntries`\n* `Crell\\Bundle\\Planedo\\Message\\UpdateFeed`\n\n## Theming\n\nOut of the box, Planedo comes with barely any theming.  It works, but it's not pretty.\n\nYou are free to retheme any of the templates as you wish.  See the `templates/` directory for the full set that can be overridden.\n\n## Contributing\n\nPlease see [CONTRIBUTING](CONTRIBUTING.md) and [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) for details.\n\n## Security\n\nIf you discover any security related issues, please email larry at garfieldtech dot com instead of using the issue tracker.\n\n## Credits\n\n- [Larry Garfield][link-author]\n- [All Contributors][link-contributors]\n\n## License\n\nThe Affero GPL version 3 or later. Please see [License File](LICENSE.md) for more information.\n\n[ico-version]: https://img.shields.io/packagist/v/Crell/PlanedoBundle.svg?style=flat-square\n[ico-license]: https://img.shields.io/badge/License-AGPLv3-green.svg?style=flat-square\n[ico-downloads]: https://img.shields.io/packagist/dt/Crell/PlanedoBundle.svg?style=flat-square\n\n[link-packagist]: https://packagist.org/packages/crell/planedo-bundle\n[link-scrutinizer]: https://scrutinizer-ci.com/g/Crell/PlanedoBundle/code-structure\n[link-code-quality]: https://scrutinizer-ci.com/g/Crell/PlanedoBundle\n[link-downloads]: https://packagist.org/packages/crell/planedo-bundle\n[link-author]: https://github.com/Crell\n[link-contributors]: ../../contributors\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrell%2Fplanedobundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrell%2Fplanedobundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrell%2Fplanedobundle/lists"}