README

Kirby Plugin to view recently modified pages by current User

Installation

• unzip master.zip as folder site/plugins/kirby3-recently-modified or
• git submodule add https://github.com/bnomei/kirby3-recently-modified.git site/plugins/kirby3-recently-modified or
• composer require bnomei/kirby3-recently-modified

Screenshot

Section

Field

Usage

Add 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.

site/blueprints/site.yml

sections:
  listPagesModifiedByUser:
    type: recentlymodified
    headline: Your Recently Modified Pages
    # query

Optionally 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).

site/blueprints/pages/default.yml

fields:
  showWhichUserModifiedPage:
    type: recentlymodified
    label: Recently Modified By
    # interval: 60

Warning

This plugin has, by default, a 1 minute cache.

Query for the Section (not Field)

The 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.

Default Query

site.index(true).sortBy('modified', 'desc').onlyModifiedByUser

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.

Example 1

sections:
  recentarticles:
    type: recentlymodified
    headline: Recently Modified Articles
    query: site.find('articles').children.listed.sortBy('modified', 'desc')

Example 2

sections:
  mycollection:
    type: recentlymodified
    headline: My Collection
    query: kirby.collection('my-collection')

return [
    'bnomei.recently-modified.limit' => 25, // default: 7
    'bnomei.recently-modified.info' => function ($page) {
        return $page->id();
    },
    // other options...
];

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.

Adjusting the Date formats

You 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.

site/config/config.php

<?php

return [
    // ... other values

    'date'  => [
        'handler' => 'date', // <!-- you could adjust the date handler here
    ],

    'bnomei.recently-modified.format' => function($datetime): string {
        $handler = kirby()->option('date.handler') ?? 'date';
        $formats = [
            'date' => 'Y/m/d H:i:s',          // <!-- the formats here
            'intl' => 'dd. MMMM yyyy, HH:mm', // <!-- and here
            'strftime' => '%Y/%m/%d %H:%M:%S' // <!-- or here
        ];
        $format = $formats[$handler] ?? $formats['date'];

        return Str::date($datetime, $format, $handler);
    },
];

Known Limitations

• You can not set multiple text/link/info settings. All instances of the recentlymodified section share the same.
• 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.

Settings

Disclaimer

This 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.

License

MIT

It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.