{"id":15653672,"url":"https://github.com/bnomei/kirby3-recently-modified","last_synced_at":"2025-09-13T10:58:45.995Z","repository":{"id":57673823,"uuid":"482322998","full_name":"bnomei/kirby3-recently-modified","owner":"bnomei","description":"Kirby Section to display recently modified content pages by current User","archived":false,"fork":false,"pushed_at":"2025-02-23T15:05:23.000Z","size":1638,"stargazers_count":29,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-24T18:08:31.852Z","etag":null,"topics":["changes","kirby","kirby-4","kirby-5","kirby-cms","kirby-plugin","list","modified","page","pages","recently","user","widget"],"latest_commit_sha":null,"homepage":"https://forum.getkirby.com/t/kirby-3-recently-modified-show-edited-pages-by-current-panel-user/25274","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bnomei.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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":"bnomei","patreon":"bnomei","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://buymeacoff.ee/bnomei","https://paypal.me/bnomei"]}},"created_at":"2022-04-16T17:49:14.000Z","updated_at":"2025-02-23T15:06:04.000Z","dependencies_parsed_at":"2024-09-12T22:26:26.176Z","dependency_job_id":"c298823f-e8e5-4908-9ff8-d5a4bdfd15e3","html_url":"https://github.com/bnomei/kirby3-recently-modified","commit_stats":{"total_commits":32,"total_committers":3,"mean_commits":"10.666666666666666","dds":0.1875,"last_synced_commit":"1a4196544237a45e50e21ec20a94fff5653db2d7"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/bnomei/kirby3-recently-modified","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnomei%2Fkirby3-recently-modified","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnomei%2Fkirby3-recently-modified/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnomei%2Fkirby3-recently-modified/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnomei%2Fkirby3-recently-modified/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bnomei","download_url":"https://codeload.github.com/bnomei/kirby3-recently-modified/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bnomei%2Fkirby3-recently-modified/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271083890,"owners_count":24696395,"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","status":"online","status_checked_at":"2025-08-18T02:00:08.743Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["changes","kirby","kirby-4","kirby-5","kirby-cms","kirby-plugin","list","modified","page","pages","recently","user","widget"],"created_at":"2024-10-03T12:46:26.761Z","updated_at":"2025-09-13T10:58:45.986Z","avatar_url":"https://github.com/bnomei.png","language":"PHP","funding_links":["https://github.com/sponsors/bnomei","https://patreon.com/bnomei","https://buymeacoff.ee/bnomei","https://paypal.me/bnomei","https://www.buymeacoffee.com/bnomei"],"categories":[],"sub_categories":[],"readme":"# Kirby Recently Modified\n\n![Release](https://flat.badgen.net/packagist/v/bnomei/kirby3-recently-modified?color=ae81ff\u0026icon=github\u0026label)\n[![Discord](https://flat.badgen.net/badge/discord/bnomei?color=7289da\u0026icon=discord\u0026label)](https://discordapp.com/users/bnomei)\n[![Buymecoffee](https://flat.badgen.net/badge/icon/donate?icon=buymeacoffee\u0026color=FF813F\u0026label)](https://www.buymeacoffee.com/bnomei)\n\nKirby Plugin to view recently modified pages by current User\n\n## Installation\n\n- unzip [master.zip](https://github.com/bnomei/kirby3-recently-modified/archive/master.zip) as folder `site/plugins/kirby3-recently-modified` or\n- `git submodule add https://github.com/bnomei/kirby3-recently-modified.git site/plugins/kirby3-recently-modified` or\n- `composer require bnomei/kirby3-recently-modified`\n\n## Screenshot\n\n### Section\n![recently-modified](https://raw.githubusercontent.com/bnomei/kirby3-recently-modified/master/screenshot.png)\n\n### Field\n![recently-modified](https://raw.githubusercontent.com/bnomei/kirby3-recently-modified/master/screenshot.gif)\n\n## Usage\n\nAdd the section to your site or page blueprint to display a list of the most recently modified pages by the currently logged in user. The sections is not able to list the site itself since the section depends on a collection of pages for the query.\n\n**site/blueprints/site.yml**\n```yaml\nsections:\n  listPagesModifiedByUser:\n    type: recentlymodified\n    headline: Your Recently Modified Pages\n    # query\n```\n\nOptionally you can add the field to the site or any page blueprint to show the time and user that modified given content most recently. In contrast to the section the field is able to show most recent modified information for the site (`content/site.txt`).\n\n**site/blueprints/pages/default.yml**\n```yaml\nfields:\n  showWhichUserModifiedPage:\n    type: recentlymodified\n    label: Recently Modified By\n    # interval: 60\n```\n\n\u003e [!WARNING]\n\u003e This plugin has, by default, a 1 minute cache.\n\n### Query for the Section (not Field)\n\nThe plugins section comes with a default query that shows the most recent changes made by the currently logged in user. But you can define any other query you like.\n\n**Default Query**\n```\nsite.index(true).sortBy('modified', 'desc').onlyModifiedByUser\n```\n\n\u003e `onlyModifiedByUser` is a PagesMethod added by this plugin that filters the page collection to only those pages that were modified by the currently logged-in user. The plugin uses hooks to track what pages each user did edit.\n\n**Example 1**\n```yaml\nsections:\n  recentarticles:\n    type: recentlymodified\n    headline: Recently Modified Articles\n    query: site.find('articles').children.listed.sortBy('modified', 'desc')\n```\n\n**Example 2**\n```yaml\nsections:\n  mycollection:\n    type: recentlymodified\n    headline: My Collection\n    query: kirby.collection('my-collection')\n```\n```php\nreturn [\n    'bnomei.recently-modified.limit' =\u003e 25, // default: 7\n    'bnomei.recently-modified.info' =\u003e function ($page) {\n        return $page-\u003eid();\n    },\n    // other options...\n];\n```\n\n\u003e TIP: You could use the `query` property, `info` and `limit` settings to show any list of pages you want, just like a simplified version of the page table plugin.\n\n## Adjusting the Date formats\n\nYou can adjust the date formats based on the `date.handler` option. The default is `date`. The plugin `bnomei.recently-modified.format` is a callback that takes the `$datetime` string to format and ideally provides a format for all possible date handlers, returning the formatted string.\n\n**site/config/config.php**\n```php\n\u003c?php\n\nreturn [\n    // ... other values\n\n    'date'  =\u003e [\n        'handler' =\u003e 'date', // \u003c!-- you could adjust the date handler here\n    ],\n\n    'bnomei.recently-modified.format' =\u003e function($datetime): string {\n        $handler = kirby()-\u003eoption('date.handler') ?? 'date';\n        $formats = [\n            'date' =\u003e 'Y/m/d H:i:s',          // \u003c!-- the formats here\n            'intl' =\u003e 'dd. MMMM yyyy, HH:mm', // \u003c!-- and here\n            'strftime' =\u003e '%Y/%m/%d %H:%M:%S' // \u003c!-- or here\n        ];\n        $format = $formats[$handler] ?? $formats['date'];\n\n        return Str::date($datetime, $format, $handler);\n    },\n];\n```\n\n## Known Limitations\n\n- You can not set multiple `text`/`link`/`info` settings. All instances of the `recentlymodified` section share the same.\n- The `limit` setting is always applied. If you want some of your instances to have a smaller number of items then call `limit` inside your custom query.\n\n## Settings\n\n| bnomei.recently-modified. | Default                | Description                             |            \n|---------------------------|------------------------|-----------------------------------------|\n| query                     | `...`                  | see above                               |\n| link                      | `function($page){...}` | callback to return the link             |\n| text                      | `function($page){...}` | callback to return the text             |\n| info                      | `function($page){...}` | callback to return the info             |\n| format                    | `fn($datetime){...}`   | custom date format callback             |\n| hooks                     | `true`                 | use hooks to track users modified pages |\n| limit                     | `7`                    | limit list and cache items              |\n| expire                    | `1`                    | cache will expire n-minutes             |\n\n## Disclaimer\n\nThis plugin is provided \"as is\" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please [create a new issue](https://github.com/bnomei/kirby3-recently-modified/issues/new).\n\n## License\n\n[MIT](https://opensource.org/licenses/MIT)\n\nIt is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbnomei%2Fkirby3-recently-modified","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbnomei%2Fkirby3-recently-modified","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbnomei%2Fkirby3-recently-modified/lists"}