JcDenis
/
periodical
1
0
Fork 0
Code Issues Pull Requests Releases 3 Activity

Compare commits

base: JcDenis:master
Branches Tags
JcDenis:master
JcDenis:v2023.11.04
JcDenis:v2023.10.20
JcDenis:v2023.08.15
..
compare: JcDenis:v2023.08.15
Branches Tags
JcDenis:master
JcDenis:v2023.11.04
JcDenis:v2023.10.20
JcDenis:v2023.08.15

No commits in common. "master" and "v2023.08.15" have entirely different histories.
master ... v2023.08.1

19 changed files with 431 additions and 396 deletions
Show Stats Expand all files Collapse all files

14
CHANGELOG.md
View File

@ -1,17 +1,3 @@
periodical 2023.11.04
===========================================================
* Require Dotclear 2.28
* Require PHP 8.1
* Fix typo
* Fix perms
* Code review (phpstan)
periodical 2023.10.20
===========================================================
* Require Dotclear 2.28
* Require PHP 8.1
* Upgrade to Dotclear 2.28
periodical 2023.08.15 periodical 2023.08.15
=========================================================== ===========================================================
* Require Dotclear 2.27 * Require Dotclear 2.27

30
README.md
View File

@ -1,25 +1,28 @@
# README # README
[![Release](https://img.shields.io/badge/release-2023.11.04-a2cbe9.svg)](https://git.dotclear.watch/JcDenis/periodical/releases) [![Release](https://img.shields.io/badge/release-2023.08.15-a2cbe9.svg)](https://git.dotclear.watch/JcDenis/periodical/releases)
![Date](https://img.shields.io/badge/date-2023.11.04-c44d58.svg) [![Date](https://img.shields.io/badge/date-2023.08.15-c44d58.svg)](https://git.dotclear.watch/JcDenis/periodical/releases)
[![Dotclear](https://img.shields.io/badge/dotclear-v2.27-137bbb.svg)](https://fr.dotclear.org/download) [![Dotclear](https://img.shields.io/badge/dotclear-v2.27-137bbb.svg)](https://fr.dotclear.org/download)
[![Dotaddict](https://img.shields.io/badge/dotaddict-official-9ac123.svg)](https://plugins.dotaddict.org/dc2/details/periodical) [![Dotaddict](https://img.shields.io/badge/dotaddict-official-9ac123.svg)](https://plugins.dotaddict.org/dc2/details/periodical)
[![License](https://img.shields.io/badge/license-GPL--2.0-ececec.svg)](https://git.dotclear.watch/JcDenis/periodical/src/branch/master/LICENSE) [![License](https://img.shields.io/github/license/JcDenis/periodical)](https://git.dotclear.watch/JcDenis/periodical/blob/master/LICENSE)
## ABOUT ## WHAT IS PERIODICAL ?
_periodical_ is a plugin for the open-source web publishing software called [Dotclear](https://www.dotclear.org). _Periodical_ is a plugin for the open-source
web publishing software called Dotclear.
> Manage and publish automatically lists of posts You can manage and publish automatically lists of posts
at regular periods. For exemple, you just need to add posts to a period at regular periods. For exemple, you just need to add posts to a period
and they will be publish ones after the others every week. and they will be publish ones after the others every week.
## REQUIREMENTS ## REQUIREMENTS
* Dotclear 2.28 _periodical_ requires:
* admin permissions to configure plugin
* usage,contentadmin permissions to link feeds
* Dotclear 2.27
* PHP 8.1+ * PHP 8.1+
* Dotclear admin permissions to configure plugin
* Dotclear usage,contentadmin permissions to link feeds
## NOTICE ## NOTICE
@ -42,11 +45,10 @@ You can also add or remove period to multiple posts from posts actions page.
## LINKS ## LINKS
* [License](https://git.dotclear.watch/JcDenis/periodical/src/branch/master/LICENSE) * License : [GNU GPL v2](https://www.gnu.org/licenses/old-licenses/lgpl-2.0.html)
* [Packages & details](https://git.dotclear.watch/JcDenis/periodical/releases) (or on [Dotaddict](https://plugins.dotaddict.org/dc2/details/periodical)) * Source & contribution : [Gitea Page](https://git.dotclear.watch/JcDenis/periodical) or [GitHub Page](https://github.com/JcDenis/periodical)
* [Sources & contributions](https://git.dotclear.watch/JcDenis/periodical) (or on [GitHub](https://github.com/JcDenis/periodical)) * Packages & details: [Gitea Page](https://git.dotclear.watch/JcDenis/periodical/releases) or [Dotaddict Page](https://plugins.dotaddict.org/dc2/details/periodical)
* [Issues & security](https://git.dotclear.watch/JcDenis/periodical/issues) (or on [GitHub](https://github.com/JcDenis/periodical/issues)) * Discuss & help : [Dotclear Forum](https://forum.dotclear.org/viewtopic.php?id=42289)
* [Discuss & help](https://forum.dotclear.org/viewtopic.php?id=42289)
## CONTRIBUTORS ## CONTRIBUTORS

31
_define.php
View File

@ -1,27 +1,36 @@
<?php <?php
/** /**
* @file * @brief periodical, a plugin for Dotclear 2
* @brief The plugin periodical definition
* @ingroup periodical
* *
* @defgroup periodical Plugin periodical. * @package Dotclear
* @subpackage Plugin
* *
* Published periodically entries. * @author Jean-Christian Denis and contributors
* *
* @author Jean-Christian Denis * @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
declare(strict_types=1); if (!defined('DC_RC_PATH')) {
return null;
}
$this->registerModule( $this->registerModule(
'Periodical', 'Periodical',
'Published periodically entries', 'Published periodically entries',
'Jean-Christian Denis and contributors', 'Jean-Christian Denis and contributors',
'2023.11.04', '2023.08.15',
[ [
'requires' => [['core', '2.28']], 'requires' => [
'permissions' => 'My', ['php', '8.1'],
'settings' => ['blog' => '#params.' . basename(__DIR__) . '_params'], ['core', '2.27'],
],
'permissions' => dcCore::app()->auth->makePermissions([
dcCore::app()->auth::PERMISSION_USAGE,
dcCore::app()->auth::PERMISSION_CONTENT_ADMIN,
]),
'settings' => [
'blog' => '#params.' . basename(__DIR__) . '_params',
],
'type' => 'plugin', 'type' => 'plugin',
'support' => 'https://git.dotclear.watch/JcDenis/' . basename(__DIR__) . '/issues', 'support' => 'https://git.dotclear.watch/JcDenis/' . basename(__DIR__) . '/issues',
'details' => 'https://git.dotclear.watch/JcDenis/' . basename(__DIR__) . '/src/branch/master/README.md', 'details' => 'https://git.dotclear.watch/JcDenis/' . basename(__DIR__) . '/src/branch/master/README.md',

21
_init.php 100644
View File

@ -0,0 +1,21 @@
<?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
if (!defined('DC_RC_PATH')) {
return null;
}
class initPeriodical
{
// now use My::id()
public const PERIOD_TABLE_NAME = 'periodical';
}

6
dcstore.xml
View File

@ -2,11 +2,11 @@
<modules xmlns:da="http://dotaddict.org/da/"> <modules xmlns:da="http://dotaddict.org/da/">
<module id="periodical"> <module id="periodical">
<name>Periodical</name> <name>Periodical</name>
<version>2023.11.04</version> <version>2023.08.15</version>
<author>Jean-Christian Denis and contributors</author> <author>Jean-Christian Denis and contributors</author>
<desc>Published periodically entries</desc> <desc>Published periodically entries</desc>
<file>https://git.dotclear.watch/JcDenis/periodical/releases/download/v2023.11.04/plugin-periodical.zip</file> <file>https://git.dotclear.watch/JcDenis/periodical/releases/download/v2023.08.15/plugin-periodical.zip</file>
<da:dcmin>2.28</da:dcmin> <da:dcmin>2.27</da:dcmin>
<da:details>https://git.dotclear.watch/JcDenis/periodical/src/branch/master/README.md</da:details> <da:details>https://git.dotclear.watch/JcDenis/periodical/src/branch/master/README.md</da:details>
<da:support>https://git.dotclear.watch/JcDenis/periodical/issues</da:support> <da:support>https://git.dotclear.watch/JcDenis/periodical/issues</da:support>
</module> </module>

27
locales/en/resources.php
View File

@ -1,10 +1,19 @@
<?php <?php
/**
* @file # -- BEGIN LICENSE BLOCK ----------------------------------
* @brief The plugin periodical definition #
* @ingroup periodical # This file is part of periodical, a plugin for Dotclear 2.
* #
* @author Jean-Christian Denis # Copyright (c) 2009-2021 Jean-Christian Denis and contributors
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html #
*/ # Licensed under the GPL version 2.0 license.
\Dotclear\App::backend()->resources()->set('help', 'periodical', __DIR__ . '/help/help.html'); # A copy of this license is available in LICENSE file or at
# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
#
# -- END LICENSE BLOCK ------------------------------------
if (!defined('DC_RC_PATH')) {
return null;
}
dcCore::app()->resources['help']['periodical'] = __DIR__ . '/help/help.html';

27
locales/fr/resources.php
View File

@ -1,10 +1,19 @@
<?php <?php
/**
* @file # -- BEGIN LICENSE BLOCK ----------------------------------
* @brief The plugin periodical definition #
* @ingroup periodical # This file is part of periodical, a plugin for Dotclear 2.
* #
* @author Jean-Christian Denis # Copyright (c) 2009-2021 Jean-Christian Denis and contributors
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html #
*/ # Licensed under the GPL version 2.0 license.
\Dotclear\App::backend()->resources()->set('help', 'periodical', __DIR__ . '/help/help.html'); # A copy of this license is available in LICENSE file or at
# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
#
# -- END LICENSE BLOCK ------------------------------------
if (!defined('DC_RC_PATH')) {
return null;
}
dcCore::app()->resources['help']['periodical'] = __DIR__ . '/help/help.html';

51
src/Backend.php
View File

@ -1,19 +1,22 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use Dotclear\App; use dcCore;
use Dotclear\Core\Process; use Dotclear\Core\Process;
/**
* @brief periodical backend class.
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class Backend extends Process class Backend extends Process
{ {
public static function init(): bool public static function init(): bool
@ -28,14 +31,14 @@ class Backend extends Process
} }
// register backend behaviors // register backend behaviors
App::behavior()->addBehaviors([ dcCore::app()->addBehaviors([
'adminBlogPreferencesFormV2' => BackendBehaviors::adminBlogPreferencesFormV2(...), 'adminBlogPreferencesFormV2' => [BackendBehaviors::class, 'adminBlogPreferencesFormV2'],
'adminBeforeBlogSettingsUpdate' => BackendBehaviors::adminBeforeBlogSettingsUpdate(...), 'adminBeforeBlogSettingsUpdate' => [BackendBehaviors::class, 'adminBeforeBlogSettingsUpdate'],
'adminFiltersListsV2' => BackendBehaviors::adminFiltersListsV2(...), 'adminFiltersListsV2' => [BackendBehaviors::class, 'adminFiltersListsV2'],
'adminColumnsListsV2' => BackendBehaviors::adminColumnsListsV2(...), 'adminColumnsListsV2' => [BackendBehaviors::class, 'adminColumnsListsV2'],
'adminPostListHeaderV2' => BackendBehaviors::adminPostListHeaderV2(...), 'adminPostListHeaderV2' => [BackendBehaviors::class, 'adminPostListHeaderV2'],
'adminPostListValueV2' => BackendBehaviors::adminPostListValueV2(...), 'adminPostListValueV2' => [BackendBehaviors::class, 'adminPostListValueV2'],
'adminBeforePostDelete' => BackendBehaviors::adminBeforePostDelete(...), 'adminBeforePostDelete' => [BackendBehaviors::class, 'adminBeforePostDelete'],
]); ]);
if (My::settings()->get('periodical_active')) { if (My::settings()->get('periodical_active')) {
@ -43,13 +46,13 @@ class Backend extends Process
My::addBackendMenuItem(); My::addBackendMenuItem();
// register bakend behaviors required user permissions // register bakend behaviors required user permissions
App::behavior()->addBehaviors([ dcCore::app()->addBehaviors([
'adminDashboardFavoritesV2' => BackendBehaviors::adminDashboardFavoritesV2(...), 'adminDashboardFavoritesV2' => [BackendBehaviors::class, 'adminDashboardFavoritesV2'],
'adminPostHeaders' => BackendBehaviors::adminPostHeaders(...), 'adminPostHeaders' => [BackendBehaviors::class, 'adminPostHeaders'],
'adminPostsActions' => BackendBehaviors::adminPostsActions(...), 'adminPostsActions' => [BackendBehaviors::class, 'adminPostsActions'],
'adminPostFormItems' => BackendBehaviors::adminPostFormItems(...), 'adminPostFormItems' => [BackendBehaviors::class, 'adminPostFormItems'],
'adminAfterPostUpdate' => BackendBehaviors::adminAfterPostSave(...), 'adminAfterPostUpdate' => [BackendBehaviors::class, 'adminAfterPostSave'],
'adminAfterPostCreate' => BackendBehaviors::adminAfterPostSave(...), 'adminAfterPostCreate' => [BackendBehaviors::class, 'adminAfterPostSave'],
]); ]);
} }

103
src/BackendBehaviors.php
View File

@ -1,11 +1,22 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use ArrayObject; use ArrayObject;
use Dotclear\App; use dcCore;
use dcSettings;
use Dotclear\Core\Backend\{ use Dotclear\Core\Backend\{
Favorites, Favorites,
Notices, Notices,
@ -28,31 +39,23 @@ use Dotclear\Helper\Html\Form\{
Text Text
}; };
use Dotclear\Helper\Html\Html; use Dotclear\Helper\Html\Html;
use Dotclear\Interface\Core\BlogSettingsInterface;
use Exception; use Exception;
/** /**
* @brief periodical backend behaviors class. * @ingroup DC_PLUGIN_PERIODICAL
* @ingroup periodical * @brief Periodical - admin methods.
* * @since 2.6
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class BackendBehaviors class BackendBehaviors
{ {
/**
* Periods combo.
*
* @var array<string, int> $combo_period
*/
private static array $combo_period = []; private static array $combo_period = [];
/** /**
* Add settings to blog preference. * Add settings to blog preference.
* *
* @param BlogSettingsInterface $blog_settings BlogSettingsInterface instance * @param dcSettings $blog_settings dcSettings instance
*/ */
public static function adminBlogPreferencesFormV2(BlogSettingsInterface $blog_settings): void public static function adminBlogPreferencesFormV2(dcSettings $blog_settings): void
{ {
$s = $blog_settings->get(My::id()); $s = $blog_settings->get(My::id());
@ -84,9 +87,9 @@ class BackendBehaviors
/** /**
* Save blog settings. * Save blog settings.
* *
* @param BlogSettingsInterface $blog_settings BlogSettingsInterface instance * @param dcSettings $blog_settings dcSettings instance
*/ */
public static function adminBeforeBlogSettingsUpdate(BlogSettingsInterface $blog_settings): void public static function adminBeforeBlogSettingsUpdate(dcSettings $blog_settings): void
{ {
$blog_settings->get(My::id())->put('periodical_active', !empty($_POST['periodical_active'])); $blog_settings->get(My::id())->put('periodical_active', !empty($_POST['periodical_active']));
$blog_settings->get(My::id())->put('periodical_upddate', !empty($_POST['periodical_upddate'])); $blog_settings->get(My::id())->put('periodical_upddate', !empty($_POST['periodical_upddate']));
@ -96,7 +99,7 @@ class BackendBehaviors
/** /**
* User pref for periods columns lists. * User pref for periods columns lists.
* *
* @param ArrayObject<string, mixed> $cols Columns * @param ArrayObject $cols Columns
*/ */
public static function adminColumnsListsV2(ArrayObject $cols): void public static function adminColumnsListsV2(ArrayObject $cols): void
{ {
@ -117,7 +120,7 @@ class BackendBehaviors
/** /**
* User pref periods filters options. * User pref periods filters options.
* *
* @param ArrayObject<string, mixed> $sorts Sort options * @param ArrayObject $sorts Sort options
*/ */
public static function adminFiltersListsV2(ArrayObject $sorts): void public static function adminFiltersListsV2(ArrayObject $sorts): void
{ {
@ -133,8 +136,8 @@ class BackendBehaviors
/** /**
* Add columns period to posts list header. * Add columns period to posts list header.
* *
* @param MetaRecord $rs Record instance * @param MetaRecord $rs record instance
* @param ArrayObject<string, mixed> $cols Columns * @param ArrayObject $cols Columns
*/ */
public static function adminPostListHeaderV2(MetaRecord $rs, ArrayObject $cols): void public static function adminPostListHeaderV2(MetaRecord $rs, ArrayObject $cols): void
{ {
@ -146,8 +149,8 @@ class BackendBehaviors
/** /**
* Add columns period to posts list values. * Add columns period to posts list values.
* *
* @param MetaRecord $rs Record instance * @param MetaRecord $rs record instance
* @param ArrayObject<string, mixed> $cols Columns * @param ArrayObject $cols Columns
*/ */
public static function adminPostListValueV2(MetaRecord $rs, ArrayObject $cols): void public static function adminPostListValueV2(MetaRecord $rs, ArrayObject $cols): void
{ {
@ -177,9 +180,9 @@ class BackendBehaviors
'url' => My::manageUrl(), 'url' => My::manageUrl(),
'small-icon' => My::icons(), 'small-icon' => My::icons(),
'large-icon' => My::icons(), 'large-icon' => My::icons(),
'permissions' => App::auth()->makePermissions([ 'permissions' => dcCore::app()->auth->makePermissions([
App::auth()::PERMISSION_USAGE, dcCore::app()->auth::PERMISSION_USAGE,
App::auth()::PERMISSION_CONTENT_ADMIN, dcCore::app()->auth::PERMISSION_CONTENT_ADMIN,
]), ]),
]); ]);
} }
@ -213,16 +216,16 @@ class BackendBehaviors
{ {
$pa->addAction( $pa->addAction(
[My::name() => [__('Add to periodical') => 'periodical_add']], [My::name() => [__('Add to periodical') => 'periodical_add']],
self::callbackAdd(...) [self::class, 'callbackAdd']
); );
if (App::auth()->check(App::auth()->makePermissions([ if (dcCore::app()->auth?->check(dcCore::app()->auth->makePermissions([
App::auth()::PERMISSION_DELETE, dcCore::app()->auth::PERMISSION_DELETE,
App::auth()::PERMISSION_CONTENT_ADMIN, dcCore::app()->auth::PERMISSION_CONTENT_ADMIN,
]), App::blog()->id())) { ]), dcCore::app()->blog?->id)) {
$pa->addAction( $pa->addAction(
[My::name() => [__('Remove from periodical') => 'periodical_remove']], [My::name() => [__('Remove from periodical') => 'periodical_remove']],
self::callbackRemove(...) [self::class, 'callbackRemove']
); );
} }
} }
@ -231,7 +234,7 @@ class BackendBehaviors
* Posts actions callback to remove period. * Posts actions callback to remove period.
* *
* @param ActionsPosts $pa ActionsPosts instance * @param ActionsPosts $pa ActionsPosts instance
* @param ArrayObject<string, mixed> $post _POST actions * @param ArrayObject $post _POST actions
*/ */
public static function callbackRemove(ActionsPosts $pa, ArrayObject $post): void public static function callbackRemove(ActionsPosts $pa, ArrayObject $post): void
{ {
@ -242,16 +245,16 @@ class BackendBehaviors
} }
// No right // No right
if (!App::auth()->check(App::auth()->makePermissions([ if (!dcCore::app()->auth?->check(dcCore::app()->auth->makePermissions([
App::auth()::PERMISSION_DELETE, dcCore::app()->auth::PERMISSION_DELETE,
App::auth()::PERMISSION_CONTENT_ADMIN, dcCore::app()->auth::PERMISSION_CONTENT_ADMIN,
]), App::blog()->id())) { ]), dcCore::app()->blog?->id)) {
throw new Exception(__('No enough right')); throw new Exception(__('No enough right'));
} }
// Remove linked period // Remove linked period
foreach ($posts_ids as $post_id) { foreach ($posts_ids as $post_id) {
self::delPeriod((int) $post_id); self::delPeriod($post_id);
} }
Notices::addSuccessNotice(__('Posts have been removed from periodical.')); Notices::addSuccessNotice(__('Posts have been removed from periodical.'));
@ -262,7 +265,7 @@ class BackendBehaviors
* Posts actions callback to add period. * Posts actions callback to add period.
* *
* @param ActionsPosts $pa ActionsPosts instance * @param ActionsPosts $pa ActionsPosts instance
* @param ArrayObject<string, mixed> $post _POST actions * @param ArrayObject $post _POST actions
*/ */
public static function callbackAdd(ActionsPosts $pa, ArrayObject $post): void public static function callbackAdd(ActionsPosts $pa, ArrayObject $post): void
{ {
@ -277,8 +280,8 @@ class BackendBehaviors
// Save action // Save action
if (!empty($post['periodical'])) { if (!empty($post['periodical'])) {
foreach ($posts_ids as $post_id) { foreach ($posts_ids as $post_id) {
self::delPeriod((int) $post_id); self::delPeriod($post_id);
self::addPeriod((int) $post_id, (int) $post['periodical']); self::addPeriod($post_id, (int) $post['periodical']);
} }
Notices::addSuccessNotice(__('Posts have been added to periodical.')); Notices::addSuccessNotice(__('Posts have been added to periodical.'));
@ -289,7 +292,7 @@ class BackendBehaviors
else { else {
$pa->beginPage( $pa->beginPage(
Page::breadcrumb([ Page::breadcrumb([
Html::escapeHTML(App::blog()->name()) => '', Html::escapeHTML((string) dcCore::app()->blog?->name) => '',
$pa->getCallerTitle() => $pa->getRedirection(true), $pa->getCallerTitle() => $pa->getRedirection(true),
__('Add a period to this selection') => '', __('Add a period to this selection') => '',
]) ])
@ -299,12 +302,14 @@ class BackendBehaviors
(new Form('periodicaladd'))->method('post')->action($pa->getURI())->fields([ (new Form('periodicaladd'))->method('post')->action($pa->getURI())->fields([
(new Text('', $pa->getCheckboxes())), (new Text('', $pa->getCheckboxes())),
self::formPeriod(0), self::formPeriod(0),
(new Para())->items([ (new Para())->items(array_merge(
App::nonce()->formNonce(), [
dcCore::app()->formNonce(false),
(new Hidden(['action'], 'periodical_add')), (new Hidden(['action'], 'periodical_add')),
(new Submit(['do']))->value(__('Save')), (new Submit(['do']))->value(__('Save')),
... $pa->hiddenFields(), ],
]), $pa->hiddenFields()
)),
])->render(); ])->render();
$pa->endPage(); $pa->endPage();
@ -314,8 +319,8 @@ class BackendBehaviors
/** /**
* Add form to post sidebar. * Add form to post sidebar.
* *
* @param ArrayObject<string, mixed> $main_items Main items * @param ArrayObject $main_items Main items
* @param ArrayObject<string, mixed> $sidebar_items Sidebar items * @param ArrayObject $sidebar_items Sidebar items
* @param null|MetaRecord $post Post record or null * @param null|MetaRecord $post Post record or null
*/ */
public static function adminPostFormItems(ArrayObject $main_items, ArrayObject $sidebar_items, ?MetaRecord $post): void public static function adminPostFormItems(ArrayObject $main_items, ArrayObject $sidebar_items, ?MetaRecord $post): void
@ -370,7 +375,7 @@ class BackendBehaviors
/** /**
* Combo of available periods. * Combo of available periods.
* *
* @return array<string, int> List of period * @return array List of period
*/ */
private static function comboPeriod(): array private static function comboPeriod(): array
{ {

24
src/Dater.php
View File

@ -1,21 +1,25 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use DateTimeZone; use DateTimeZone;
use Dotclear\App; use dcCore;
use Exception; use Exception;
/** /**
* @brief periodical date helper.
* @ingroup periodical
*
* Tools to manupilate period date * Tools to manupilate period date
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class Dater class Dater
{ {
@ -29,7 +33,7 @@ class Dater
*/ */
public static function fromUser(string $date, string $format = 'Y-m-d H:i:00'): string public static function fromUser(string $date, string $format = 'Y-m-d H:i:00'): string
{ {
$tz = App::auth()->getInfo('user_tz'); $tz = dcCore::app()->auth?->getInfo('user_tz');
$d = date_create($date, new DateTimeZone($tz ?? 'UTC')); $d = date_create($date, new DateTimeZone($tz ?? 'UTC'));
return $d ? date_format($d->setTimezone(new DateTimeZone('UTC')), $format) : ''; return $d ? date_format($d->setTimezone(new DateTimeZone('UTC')), $format) : '';
@ -45,7 +49,7 @@ class Dater
*/ */
public static function toUser(string $date, string $format = 'Y-m-d\TH:i'): string public static function toUser(string $date, string $format = 'Y-m-d\TH:i'): string
{ {
$tz = App::auth()->getInfo('user_tz'); $tz = dcCore::app()->auth?->getInfo('user_tz');
$d = date_create($date, new DateTimeZone('UTC')); $d = date_create($date, new DateTimeZone('UTC'));
return $d ? date_format($d->setTimezone(new DateTimeZone($tz ?? 'UTC')), $format) : ''; return $d ? date_format($d->setTimezone(new DateTimeZone($tz ?? 'UTC')), $format) : '';

49
src/Frontend.php
View File

@ -1,25 +1,32 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use Dotclear\App; use dcBlog;
use dcCore;
use Dotclear\Core\Process; use Dotclear\Core\Process;
use Exception; use Exception;
/** /**
* @brief periodical frontend class. * Update posts from periods on frontend
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class Frontend extends Process class Frontend extends Process
{ {
public static function init(): bool public static function init(): bool
{ {
return self::status(My::checkContext(My::FRONTEND) && in_array((string) App::url()->type, ['default', 'feed'])); return self::status(My::checkContext(My::FRONTEND) && in_array(dcCore::app()->url->type, ['default', 'feed']));
} }
public static function process(): bool public static function process(): bool
@ -28,8 +35,8 @@ class Frontend extends Process
return false; return false;
} }
App::behavior()->addBehavior('publicBeforeDocumentV2', function (): void { dcCore::app()->addBehavior('publicBeforeDocumentV2', function (): void {
if (!App::blog()->isDefined()) { if (is_null(dcCore::app()->blog)) {
return; return;
} }
@ -39,7 +46,7 @@ class Frontend extends Process
Utils::lockUpdate(); Utils::lockUpdate();
// Get periods // Get periods
$periods = App::auth()->sudo(Utils::getPeriods(...)); $periods = dcCore::app()->auth->sudo([Utils::class, 'getPeriods']);
// No period // No period
if ($periods->isEmpty()) { if ($periods->isEmpty()) {
@ -53,7 +60,7 @@ class Frontend extends Process
if (!preg_match('/^(post_dt|post_creadt|post_id) (asc|desc)$/', $posts_order)) { if (!preg_match('/^(post_dt|post_creadt|post_id) (asc|desc)$/', $posts_order)) {
$posts_order = 'post_dt asc'; $posts_order = 'post_dt asc';
} }
$cur_period = App::con()->openCursor(App::con()->prefix() . My::id()); $cur_period = dcCore::app()->con->openCursor(dcCore::app()->prefix . My::id());
while ($periods->fetch()) { while ($periods->fetch()) {
// Check if period is ongoing // Check if period is ongoing
@ -82,19 +89,19 @@ class Frontend extends Process
// Get posts to publish related to this period // Get posts to publish related to this period
$posts_params = []; $posts_params = [];
$posts_params['periodical_id'] = $periods->f('periodical_id'); $posts_params['periodical_id'] = $periods->f('periodical_id');
$posts_params['post_status'] = App::blog()::POST_PENDING; $posts_params['post_status'] = dcBlog::POST_PENDING;
$posts_params['order'] = $posts_order; $posts_params['order'] = $posts_order;
$posts_params['limit'] = $limit * $max_nb; $posts_params['limit'] = $limit * $max_nb;
$posts_params['no_content'] = true; $posts_params['no_content'] = true;
$posts = App::auth()->sudo(Utils::getPosts(...), $posts_params); $posts = dcCore::app()->auth->sudo([Utils::class, 'getPosts'], $posts_params);
if (!$posts->isEmpty()) { if (!$posts->isEmpty()) {
$cur_post = App::blog()->openPostCursor(); $cur_post = dcCore::app()->con->openCursor(dcCore::app()->prefix . dcBlog::POST_TABLE_NAME);
while ($posts->fetch()) { while ($posts->fetch()) {
// Publish post with right date // Publish post with right date
$cur_post->clean(); $cur_post->clean();
$cur_post->setField('post_status', App::blog()::POST_PUBLISHED); $cur_post->setField('post_status', dcBlog::POST_PUBLISHED);
// Update post date with right date // Update post date with right date
if ($s->get('periodical_upddate')) { if ($s->get('periodical_upddate')) {
@ -105,7 +112,7 @@ class Frontend extends Process
// Also update post url with right date // Also update post url with right date
if ($s->get('periodical_updurl')) { if ($s->get('periodical_updurl')) {
$cur_post->setField('post_url', App::blog()->getPostURL( $cur_post->setField('post_url', dcCore::app()->blog->getPostURL(
'', '',
$cur_post->getField('post_dt'), $cur_post->getField('post_dt'),
$posts->f('post_title'), $posts->f('post_title'),
@ -115,7 +122,7 @@ class Frontend extends Process
$cur_post->update( $cur_post->update(
'WHERE post_id = ' . $posts->f('post_id') . ' ' . 'WHERE post_id = ' . $posts->f('post_id') . ' ' .
"AND blog_id = '" . App::con()->escapeStr(App::blog()->id()) . "' " "AND blog_id = '" . dcCore::app()->con->escapeStr(dcCore::app()->blog->id) . "' "
); );
// Delete post relation to this period // Delete post relation to this period
@ -130,9 +137,9 @@ class Frontend extends Process
} }
// --BEHAVIOR-- periodicalAfterPublishedPeriodicalEntry // --BEHAVIOR-- periodicalAfterPublishedPeriodicalEntry
App::behavior()->callBehavior('periodicalAfterPublishedPeriodicalEntry', $posts, $periods); dcCore::app()->callBehavior('periodicalAfterPublishedPeriodicalEntry', $posts, $periods);
} }
App::blog()->triggerBlog(); dcCore::app()->blog->triggerBlog();
} }
} }
@ -141,7 +148,7 @@ class Frontend extends Process
$cur_period->setField('periodical_curdt', Dater::toDate($loop_ts, 'Y-m-d H:i:00')); $cur_period->setField('periodical_curdt', Dater::toDate($loop_ts, 'Y-m-d H:i:00'));
$cur_period->update( $cur_period->update(
'WHERE periodical_id = ' . $periods->f('periodical_id') . ' ' . 'WHERE periodical_id = ' . $periods->f('periodical_id') . ' ' .
"AND blog_id = '" . App::con()->escapeStr(App::blog()->id()) . "' " "AND blog_id = '" . dcCore::app()->con->escapeStr(dcCore::app()->blog->id) . "' "
); );
} }
} }

27
src/Install.php
View File

@ -1,21 +1,24 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use Dotclear\App; use dcCore;
use Dotclear\Core\Process; use Dotclear\Core\Process;
use Dotclear\Database\Structure; use Dotclear\Database\Structure;
use Exception; use Exception;
/**
* @brief periodical insatll class.
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class Install extends Process class Install extends Process
{ {
public static function init(): bool public static function init(): bool
@ -30,7 +33,7 @@ class Install extends Process
} }
try { try {
$t = new Structure(App::con(), App::con()->prefix()); $t = new Structure(dcCore::app()->con, dcCore::app()->prefix);
// create database table // create database table
$t->__get(My::id()) $t->__get(My::id())
@ -46,7 +49,7 @@ class Install extends Process
->primary('pk_periodical', 'periodical_id') ->primary('pk_periodical', 'periodical_id')
->index('idx_periodical_type', 'btree', 'periodical_type'); ->index('idx_periodical_type', 'btree', 'periodical_type');
(new Structure(App::con(), App::con()->prefix()))->synchronize($t); (new Structure(dcCore::app()->con, dcCore::app()->prefix))->synchronize($t);
// set default settings // set default settings
$s = My::settings(); $s = My::settings();
@ -57,7 +60,7 @@ class Install extends Process
return true; return true;
} catch (Exception $e) { } catch (Exception $e) {
App::error()->add($e->getMessage()); dcCore::app()->error->add($e->getMessage());
return false; return false;
} }

30
src/Manage.php
View File

@ -1,10 +1,20 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use Dotclear\App; use dcCore;
use Dotclear\Core\Process; use Dotclear\Core\Process;
use Dotclear\Core\Backend\{ use Dotclear\Core\Backend\{
Notices, Notices,
@ -19,11 +29,7 @@ use Dotclear\Helper\Network\Http;
use Exception; use Exception;
/** /**
* @brief periodical manage periods class. * Admin page for periods
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class Manage extends Process class Manage extends Process
{ {
@ -71,7 +77,7 @@ class Manage extends Process
My::redirect(['part' => 'periods']); My::redirect(['part' => 'periods']);
} }
} catch (Exception $e) { } catch (Exception $e) {
App::error()->add($e->getMessage()); dcCore::app()->error->add($e->getMessage());
} }
} }
@ -92,7 +98,7 @@ class Manage extends Process
My::redirect(['part' => 'periods']); My::redirect(['part' => 'periods']);
} }
} catch (Exception $e) { } catch (Exception $e) {
App::error()->add($e->getMessage()); dcCore::app()->error->add($e->getMessage());
} }
} }
@ -127,7 +133,7 @@ class Manage extends Process
$counter = Utils::getPeriods($params, true); $counter = Utils::getPeriods($params, true);
$period_list = new ManageList($periods, $counter->f(0)); $period_list = new ManageList($periods, $counter->f(0));
} catch (Exception $e) { } catch (Exception $e) {
App::error()->add($e->getMessage()); dcCore::app()->error->add($e->getMessage());
} }
// Display // Display
@ -144,7 +150,7 @@ class Manage extends Process
Notices::getNotices() . Notices::getNotices() .
'<p class="top-add"> '<p class="top-add">
<a class="button add" href="' . My::manageUrl(['part' => 'period']) . '">' . __('New period') . '</a> <a class="button add" href="' . dcCore::app()->admin->getPageURL() . '&amp;part=period">' . __('New period') . '</a>
</p>'; </p>';
if (isset($period_list)) { if (isset($period_list)) {
@ -154,7 +160,7 @@ class Manage extends Process
// Periods list // Periods list
$period_list->periodDisplay( $period_list->periodDisplay(
$p_filter, $p_filter,
'<form action="' . My::manageUrl() . '" method="post" id="form-periods">' . '<form action="' . dcCore::app()->admin->getPageURL() . '" method="post" id="form-periods">' .
'%s' . '%s' .

39
src/ManageList.php
View File

@ -1,11 +1,22 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use ArrayObject; use ArrayObject;
use Dotclear\App; use dcBlog;
use dcCore;
use Dotclear\Core\Backend\Filter\{ use Dotclear\Core\Backend\Filter\{
Filters, Filters,
FilterPosts FilterPosts
@ -19,11 +30,9 @@ use Dotclear\Helper\Html\Form\Checkbox;
use Dotclear\Helper\Html\Html; use Dotclear\Helper\Html\Html;
/** /**
* @brief periodical periods list class. * @ingroup DC_PLUGIN_PERIODICAL
* @ingroup periodical * @brief Periodical - admin pager methods.
* * @since 2.6
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class ManageList extends Listing class ManageList extends Listing
{ {
@ -92,7 +101,7 @@ class ManageList extends Listing
*/ */
private function periodLine(bool $checked): void private function periodLine(bool $checked): void
{ {
$tz = App::auth()->getInfo('user_tz'); $tz = dcCore::app()->auth?->getInfo('user_tz');
$nb_posts = Utils::getPosts(['periodical_id' => $this->rs->f('periodical_id')], true)->f(0); $nb_posts = Utils::getPosts(['periodical_id' => $this->rs->f('periodical_id')], true)->f(0);
$url = My::manageUrl(['part' => 'period', 'period_id' => $this->rs->f('periodical_id')]); $url = My::manageUrl(['part' => 'period', 'period_id' => $this->rs->f('periodical_id')]);
$name = '<a href="' . $url . '#period" title="' . __('edit period') . '">' . Html::escapeHTML($this->rs->periodical_title) . '</a>'; $name = '<a href="' . $url . '#period" title="' . __('edit period') . '">' . Html::escapeHTML($this->rs->periodical_title) . '</a>';
@ -194,7 +203,7 @@ class ManageList extends Listing
*/ */
private function postLine(bool $checked): void private function postLine(bool $checked): void
{ {
if (App::auth()->check(App::auth()->makePermissions([App::auth()::PERMISSION_CATEGORIES]), App::blog()->id())) { if (dcCore::app()->auth?->check(dcCore::app()->auth->makePermissions([dcCore::app()->auth::PERMISSION_CATEGORIES]), dcCore::app()->blog?->id)) {
$cat_link = '<a href="category.php?id=%s">%s</a>'; $cat_link = '<a href="category.php?id=%s">%s</a>';
} else { } else {
$cat_link = '%2$s'; $cat_link = '%2$s';
@ -213,22 +222,22 @@ class ManageList extends Listing
$img_status = ''; $img_status = '';
$img = '<img alt="%1$s" title="%1$s" src="images/%2$s" />'; $img = '<img alt="%1$s" title="%1$s" src="images/%2$s" />';
switch ((int) $this->rs->f('post_status')) { switch ((int) $this->rs->f('post_status')) {
case App::blog()::POST_PUBLISHED: case dcBlog::POST_PUBLISHED:
$img_status = sprintf($img, __('published'), 'check-on.png'); $img_status = sprintf($img, __('published'), 'check-on.png');
break; break;
case App::blog()::POST_UNPUBLISHED: case dcBlog::POST_UNPUBLISHED:
$img_status = sprintf($img, __('unpublished'), 'check-off.png'); $img_status = sprintf($img, __('unpublished'), 'check-off.png');
break; break;
case App::blog()::POST_SCHEDULED: case dcBlog::POST_SCHEDULED:
$img_status = sprintf($img, __('scheduled'), 'scheduled.png'); $img_status = sprintf($img, __('scheduled'), 'scheduled.png');
break; break;
case App::blog()::POST_PENDING: case dcBlog::POST_PENDING:
$img_status = sprintf($img, __('pending'), 'check-wrn.png'); $img_status = sprintf($img, __('pending'), 'check-wrn.png');
break; break;
@ -251,11 +260,11 @@ class ManageList extends Listing
$attach = sprintf($img, sprintf($attach_str, $nb_media), 'attach.png'); $attach = sprintf($img, sprintf($attach_str, $nb_media), 'attach.png');
} }
$tz = App::auth()->getInfo('user_tz'); $tz = dcCore::app()->auth?->getInfo('user_tz');
$cols = [ $cols = [
'check' => '<td class="minimal">' . (new Checkbox(['periodical_entries[]'], $checked))->value($this->rs->f('post_id'))->render() . '</td>', 'check' => '<td class="minimal">' . (new Checkbox(['periodical_entries[]'], $checked))->value($this->rs->f('post_id'))->render() . '</td>',
'title' => '<td class="maximal"><a href="' . App::postTypes()->getPostAdminURL($this->rs->f('post_type'), $this->rs->f('post_id')) . '" ' . 'title' => '<td class="maximal"><a href="' . dcCore::app()->getPostAdminURL($this->rs->f('post_type'), $this->rs->f('post_id')) . '" ' .
'title="' . Html::escapeHTML($this->rs->getURL()) . '">' . Html::escapeHTML($this->rs->post_title) . '</a></td>', 'title="' . Html::escapeHTML($this->rs->getURL()) . '">' . Html::escapeHTML($this->rs->post_title) . '</a></td>',
'date' => '<td class="nowrap">' . Date::dt2str(__('%Y-%m-%d %H:%M'), $this->rs->f('post_dt')) . '</td>', 'date' => '<td class="nowrap">' . Date::dt2str(__('%Y-%m-%d %H:%M'), $this->rs->f('post_dt')) . '</td>',
'category' => '<td class="nowrap">' . $cat_title . '</td>', 'category' => '<td class="nowrap">' . $cat_title . '</td>',

48
src/ManagePeriod.php
View File

@ -14,7 +14,7 @@ declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use Dotclear\App; use dcCore;
use Dotclear\Core\Process; use Dotclear\Core\Process;
use Dotclear\Core\Backend\{ use Dotclear\Core\Backend\{
Notices, Notices,
@ -39,11 +39,7 @@ use Dotclear\Helper\Network\Http;
use Exception; use Exception;
/** /**
* @brief periodical manage a period class. * Admin page for a period
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class ManagePeriod extends Process class ManagePeriod extends Process
{ {
@ -58,7 +54,7 @@ class ManagePeriod extends Process
return false; return false;
} }
if (!App::blog()->isDefined()) { if (is_null(dcCore::app()->blog)) {
return false; return false;
} }
@ -67,13 +63,13 @@ class ManagePeriod extends Process
// Get period // Get period
if ($vars->bad_period_id) { if ($vars->bad_period_id) {
App::error()->add(__('This period does not exist.')); dcCore::app()->error->add(__('This period does not exist.'));
} }
// Set period // Set period
if ($vars->action == 'setperiod') { if ($vars->action == 'setperiod') {
if ($vars->bad_period_curdt || $vars->bad_period_enddt) { if ($vars->bad_period_curdt || $vars->bad_period_enddt) {
App::error()->add(__('Invalid date')); dcCore::app()->error->add(__('Invalid date'));
} }
// Check period title and dates // Check period title and dates
@ -83,19 +79,19 @@ class ManagePeriod extends Process
if (!$old_titles->isEmpty()) { if (!$old_titles->isEmpty()) {
while ($old_titles->fetch()) { while ($old_titles->fetch()) {
if (!$vars->period_id || $old_titles->f('periodical_id') != $vars->period_id) { if (!$vars->period_id || $old_titles->f('periodical_id') != $vars->period_id) {
App::error()->add(__('Period title is already taken')); dcCore::app()->error->add(__('Period title is already taken'));
} }
} }
} }
if (empty($vars->period_title)) { if (empty($vars->period_title)) {
App::error()->add(__('Period title is required')); dcCore::app()->error->add(__('Period title is required'));
} }
if (strtotime($vars->period_curdt) > strtotime($vars->period_enddt)) { if (strtotime($vars->period_curdt) > strtotime($vars->period_enddt)) {
App::error()->add(__('Start date must be older than end date')); dcCore::app()->error->add(__('Start date must be older than end date'));
} }
// If no error, set period // If no error, set period
if (!App::error()->flag()) { if (!dcCore::app()->error->flag()) {
$cur = Utils::openCursor(); $cur = Utils::openCursor();
$cur->setField('periodical_title', $vars->period_title); $cur->setField('periodical_title', $vars->period_title);
$cur->setField('periodical_curdt', $vars->period_curdt); $cur->setField('periodical_curdt', $vars->period_curdt);
@ -118,18 +114,18 @@ class ManagePeriod extends Process
} }
// Actions on related posts // Actions on related posts
if (!App::error()->flag() && $vars->period_id && $vars->action && !empty($vars->entries)) { if (!dcCore::app()->error->flag() && $vars->period_id && $vars->action && !empty($vars->entries)) {
// Publish posts // Publish posts
if ($vars->action == 'publish') { if ($vars->action == 'publish') {
try { try {
foreach ($vars->entries as $id) { foreach ($vars->entries as $id) {
App::blog()->updPostStatus($id, 1); dcCore::app()->blog->updPostStatus($id, 1);
Utils::delPost($id); Utils::delPost($id);
} }
self::redirect($vars->redir, $vars->period_id, '#posts', __('Entries successfully published.')); self::redirect($vars->redir, $vars->period_id, '#posts', __('Entries successfully published.'));
} catch (Exception $e) { } catch (Exception $e) {
App::error()->add($e->getMessage()); dcCore::app()->error->add($e->getMessage());
} }
} }
@ -137,13 +133,13 @@ class ManagePeriod extends Process
if ($vars->action == 'unpublish') { if ($vars->action == 'unpublish') {
try { try {
foreach ($vars->entries as $id) { foreach ($vars->entries as $id) {
App::blog()->updPostStatus($id, 0); dcCore::app()->blog->updPostStatus($id, 0);
Utils::delPost($id); Utils::delPost($id);
} }
self::redirect($vars->redir, $vars->period_id, '#posts', __('Entries successfully unpublished.')); self::redirect($vars->redir, $vars->period_id, '#posts', __('Entries successfully unpublished.'));
} catch (Exception $e) { } catch (Exception $e) {
App::error()->add($e->getMessage()); dcCore::app()->error->add($e->getMessage());
} }
} }
@ -156,7 +152,7 @@ class ManagePeriod extends Process
self::redirect($vars->redir, $vars->period_id, '#posts', __('Entries successfully removed.')); self::redirect($vars->redir, $vars->period_id, '#posts', __('Entries successfully removed.'));
} catch (Exception $e) { } catch (Exception $e) {
App::error()->add($e->getMessage()); dcCore::app()->error->add($e->getMessage());
} }
} }
} }
@ -194,7 +190,7 @@ class ManagePeriod extends Process
$counter = Utils::getPosts($params, true); $counter = Utils::getPosts($params, true);
$post_list = new ManageList($posts, $counter->f(0)); $post_list = new ManageList($posts, $counter->f(0));
} catch (Exception $e) { } catch (Exception $e) {
App::error()->add($e->getMessage()); dcCore::app()->error->add($e->getMessage());
} }
$starting_script = My::jsLoad('checkbox') . $starting_script = My::jsLoad('checkbox') .
@ -213,7 +209,7 @@ class ManagePeriod extends Process
echo echo
Page::breadcrumb([ Page::breadcrumb([
__('Plugins') => '', __('Plugins') => '',
My::name() => App::backend()->getPageURL() . '&amp;part=periods', My::name() => dcCore::app()->admin->getPageURL() . '&amp;part=periods',
(null === $vars->period_id ? __('New period') : __('Edit period')) => '', (null === $vars->period_id ? __('New period') : __('Edit period')) => '',
]) . ]) .
Notices::getNotices(); Notices::getNotices();
@ -222,10 +218,10 @@ class ManagePeriod extends Process
echo echo
(new Div('period'))->items([ (new Div('period'))->items([
(new Text('h3', null === $vars->period_id ? __('New period') : __('Edit period'))), (new Text('h3', null === $vars->period_id ? __('New period') : __('Edit period'))),
(new Form('periodicalbhv'))->method('post')->action(App::backend()->getPageURL())->fields([ (new Form('periodicalbhv'))->method('post')->action(dcCore::app()->admin->getPageURL())->fields([
(new Para())->items([ (new Para())->items([
(new Label(__('Title:')))->for('period_title'), (new Label(__('Title:')))->for('period_title'),
(new Input('period_title'))->size(65)->maxlength(255)->class('maximal')->value(Html::escapeHTML($vars->period_title)), (new Input('period_title'))->size(65)->maxlenght(255)->class('maximal')->value(Html::escapeHTML($vars->period_title)),
]), ]),
(new Div())->class('two-boxes')->items([ (new Div())->class('two-boxes')->items([
(new Div())->class('box odd')->items([ (new Div())->class('box odd')->items([
@ -262,8 +258,8 @@ class ManagePeriod extends Process
]), ]),
])->render(); ])->render();
if ($vars->period_id && isset($post_filter) && isset($post_list) && !App::error()->flag()) { if ($vars->period_id && isset($post_filter) && isset($post_list) && !dcCore::app()->error->flag()) {
$base_url = App::backend()->getPageURL() . $base_url = dcCore::app()->admin->getPageURL() .
'&amp;period_id=' . $vars->period_id . '&amp;period_id=' . $vars->period_id .
'&amp;part=period' . '&amp;part=period' .
'&amp;user_id=' . $post_filter->value('user_id', '') . '&amp;user_id=' . $post_filter->value('user_id', '') .
@ -295,7 +291,7 @@ class ManagePeriod extends Process
$post_list->postDisplay( $post_list->postDisplay(
$post_filter, $post_filter,
$base_url, $base_url,
'<form action="' . App::backend()->getPageURL() . '" method="post" id="form-entries">' . '<form action="' . dcCore::app()->admin->getPageURL() . '" method="post" id="form-entries">' .
'%s' . '%s' .

102
src/ManageVars.php
View File

@ -1,114 +1,64 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
/** /**
* @brief periodical vars helper class. * Admin page vars
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class ManageVars class ManageVars
{ {
/** /** @var ManageVars $container Self instance */
* Self instance.
*
* @var ManageVars $container
*/
private static $container; private static $container;
/** /** @var string $action The post form action */
* The post form action.
*
* @var string $action
*/
public readonly string $action; public readonly string $action;
/** /** @var string $redir The post form redirection */
* The post form redirection.
*
* @var string $redir
*/
public readonly string $redir; public readonly string $redir;
/** /** @var array $periods The post form periods */
* The post form periods.
*
* @var array<int, int> $periods
*/
public readonly array $periods; public readonly array $periods;
/** /** @var array $entries The post form entries */
* The post form entries.
*
* @var array<int, int> $entries
*/
public readonly array $entries; public readonly array $entries;
/** /** @var null|int $period_id The post form period id */
* The post form period id.
*
* @var null|int $period_id
*/
public readonly ?int $period_id; public readonly ?int $period_id;
/** /** @var string $period_title The psort form period title */
* The psort form period title.
*
* @var string $period_title
*/
public readonly string $period_title; public readonly string $period_title;
/** /** @var int $period_pub_nb The post form period publication number */
* The post form period publication number.
*
* @var int $period_pub_nb
*/
public readonly int $period_pub_nb; public readonly int $period_pub_nb;
/** /** @var string $period_pub_int The post form period publication interval */
* The post form period publication interval.
*
* @var string $period_pub_int
*/
public readonly string $period_pub_int; public readonly string $period_pub_int;
/** /** @var string $period_curdt The post form period current date */
* The post form period current date.
*
* @var string $period_curdt
*/
public readonly string $period_curdt; public readonly string $period_curdt;
/** /** @var string $period_curdt The post form period end date */
* The post form period end date.
*
* @var string $period_curdt
*/
public readonly string $period_enddt; public readonly string $period_enddt;
/** /** @var bool $bad_period_id Is period ID wrong */
* Is period ID wrong .
*
* @var bool $bad_period_id
*/
public readonly bool $bad_period_id; public readonly bool $bad_period_id;
/** /** @var bool $bad_period_curdt Is period current date wrong */
* Is period current date wrong.
*
* @var bool $bad_period_curdt
*/
public readonly bool $bad_period_curdt; public readonly bool $bad_period_curdt;
/** /** @var bool $bad_period_enddt Is period end date wrong */
* Is period end date wrong.
*
* @var bool $bad_period_enddt
*/
public readonly bool $bad_period_enddt; public readonly bool $bad_period_enddt;
/** /**

42
src/My.php
View File

@ -1,39 +1,43 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use Dotclear\App; use dcCore;
use Dotclear\Module\MyPlugin; use Dotclear\Module\MyPlugin;
/** /**
* @brief periodical My helper. * This module definitions.
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class My extends MyPlugin class My extends MyPlugin
{ {
public static function checkCustomContext(int $context): ?bool public static function checkCustomContext(int $context): ?bool
{ {
return match ($context) { return in_array($context, [My::MANAGE, My::MENU]) ?
// Add usage perm to backend defined('DC_CONTEXT_ADMIN')
self::MANAGE, self::MENU => App::task()->checkContext('BACKEND') && !is_null(dcCore::app()->blog)
&& App::auth()->check(App::auth()->makePermissions([ && dcCore::app()->auth->check(dcCore::app()->auth->makePermissions([
App::auth()::PERMISSION_USAGE, dcCore::app()->auth::PERMISSION_USAGE,
App::auth()::PERMISSION_CONTENT_ADMIN, dcCore::app()->auth::PERMISSION_CONTENT_ADMIN,
]), App::blog()->id()), ]), dcCore::app()->blog->id)
: null;
default => null,
};
} }
/** /**
* Periods action combo. * Periods action combo.
* *
* @return array<string, string> * @return array<string,sting>
*/ */
public static function periodsActionCombo(): array public static function periodsActionCombo(): array
{ {
@ -46,7 +50,7 @@ class My extends MyPlugin
/** /**
* Period entries action combo. * Period entries action combo.
* *
* @return array<string, array<string, string>> * @return array<string,array{string,string}>
*/ */
public static function entriesActionsCombo(): array public static function entriesActionsCombo(): array
{ {

22
src/Uninstall.php
View File

@ -1,19 +1,23 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use dcCore;
use Dotclear\Core\Process; use Dotclear\Core\Process;
use Dotclear\Plugin\Uninstaller\Uninstaller; use Dotclear\Plugin\Uninstaller\Uninstaller;
/**
* @brief periodical uninstall class.
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class Uninstall extends Process class Uninstall extends Process
{ {
public static function init(): bool public static function init(): bool
@ -23,7 +27,7 @@ class Uninstall extends Process
public static function process(): bool public static function process(): bool
{ {
if (!self::status()) { if (!self::status() || !dcCore::app()->plugins->moduleExists('Uninstaller')) {
return false; return false;
} }

98
src/Utils.php
View File

@ -1,11 +1,23 @@
<?php <?php
/**
* @brief periodical, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1); declare(strict_types=1);
namespace Dotclear\Plugin\periodical; namespace Dotclear\Plugin\periodical;
use ArrayObject; use ArrayObject;
use Dotclear\App; use dcBlog;
use dcCore;
use dcMeta;
use Dotclear\Database\{ use Dotclear\Database\{
Cursor, Cursor,
MetaRecord MetaRecord
@ -22,20 +34,12 @@ use Dotclear\Helper\File\{
use Exception; use Exception;
/** /**
* @brief periodical utils class. * Manage periodical records
* @ingroup periodical
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/ */
class Utils class Utils
{ {
/** /** @var null|string $lock File lock for update */
* File lock for update. private static $lock = null;
*
* @var null|string $lock
*/
private static ?string $lock = null;
/** /**
* Get periodical table cursor. * Get periodical table cursor.
@ -44,13 +48,13 @@ class Utils
*/ */
public static function openCursor(): Cursor public static function openCursor(): Cursor
{ {
return App::con()->openCursor(App::con()->prefix() . My::id()); return dcCore::app()->con->openCursor(dcCore::app()->prefix . My::id());
} }
/** /**
* Get periods. * Get periods.
* *
* @param array<string, mixed>|ArrayObject<string, mixed> $params Parameters * @param array|ArrayObject $params Parameters
* @param bool $count_only Only counts results * @param bool $count_only Only counts results
* @param SelectStatement $ext_sql Optional SelectStatement instance * @param SelectStatement $ext_sql Optional SelectStatement instance
* *
@ -78,7 +82,7 @@ class Utils
]); ]);
} }
$sql->from($sql->as(App::con()->prefix() . My::id(), 'T'), false, true); $sql->from($sql->as(dcCore::app()->prefix . My::id(), 'T'), false, true);
if (!empty($params['join'])) { if (!empty($params['join'])) {
$sql->join($params['join']); $sql->join($params['join']);
@ -90,9 +94,9 @@ class Utils
if (!empty($params['where'])) { if (!empty($params['where'])) {
$sql->where($params['where']); $sql->where($params['where']);
$sql->and('T.blog_id = ' . $sql->quote(App::blog()->id())); $sql->and('T.blog_id = ' . $sql->quote((string) dcCore::app()->blog?->id));
} else { } else {
$sql->where('T.blog_id = ' . $sql->quote(App::blog()->id())); $sql->where('T.blog_id = ' . $sql->quote((string) dcCore::app()->blog?->id));
} }
if (isset($params['periodical_type'])) { if (isset($params['periodical_type'])) {
@ -132,7 +136,9 @@ class Utils
$sql->limit($params['limit']); $sql->limit($params['limit']);
} }
return $sql->select() ?? MetaRecord::newFromArray([]); $rs = $sql->select();
return is_null($rs) ? MetaRecord::newFromArray([]) : $rs;
} }
/** /**
@ -144,12 +150,12 @@ class Utils
*/ */
public static function addPeriod(Cursor $cur): int public static function addPeriod(Cursor $cur): int
{ {
App::con()->writeLock(App::con()->prefix() . My::id()); dcCore::app()->con->writeLock(dcCore::app()->prefix . My::id());
try { try {
// get next id // get next id
$sql = new SelectStatement(); $sql = new SelectStatement();
$rs = $sql->from(App::con()->prefix() . My::id()) $rs = $sql->from(dcCore::app()->prefix . My::id())
->column($sql->max('periodical_id')) ->column($sql->max('periodical_id'))
->select(); ->select();
@ -157,12 +163,12 @@ class Utils
// insert // insert
$cur->setField('periodical_id', $id); $cur->setField('periodical_id', $id);
$cur->setField('blog_id', App::blog()->id()); $cur->setField('blog_id', (string) dcCore::app()->blog?->id);
$cur->setField('periodical_type', 'post'); $cur->setField('periodical_type', 'post');
$cur->insert(); $cur->insert();
App::con()->unlock(); dcCore::app()->con->unlock();
} catch (Exception $e) { } catch (Exception $e) {
App::con()->unlock(); dcCore::app()->con->unlock();
throw $e; throw $e;
} }
@ -179,7 +185,7 @@ class Utils
public static function updPeriod(int $period_id, Cursor $cur): void public static function updPeriod(int $period_id, Cursor $cur): void
{ {
$cur->update( $cur->update(
"WHERE blog_id = '" . App::con()->escapeStr(App::blog()->id()) . "' " . "WHERE blog_id = '" . dcCore::app()->con->escapeStr((string) dcCore::app()->blog?->id) . "' " .
'AND periodical_id = ' . $period_id . ' ' 'AND periodical_id = ' . $period_id . ' '
); );
} }
@ -201,8 +207,8 @@ class Utils
} }
$sql = new DeleteStatement(); $sql = new DeleteStatement();
$sql->from(App::con()->prefix() . My::id()) $sql->from(dcCore::app()->prefix . My::id())
->where('blog_id = ' . $sql->quote(App::blog()->id())) ->where('blog_id = ' . $sql->quote((string) dcCore::app()->blog?->id))
->and('periodical_id = ' . $period_id) ->and('periodical_id = ' . $period_id)
->delete(); ->delete();
} }
@ -229,7 +235,7 @@ class Utils
} }
$sql = new DeleteStatement(); $sql = new DeleteStatement();
$sql->from(App::con()->prefix() . App::meta()::META_TABLE_NAME) $sql->from(dcCore::app()->prefix . dcMeta::META_TABLE_NAME)
->where('meta_type = ' . $sql->quote(My::id())) ->where('meta_type = ' . $sql->quote(My::id()))
->and('post_id ' . $sql->in($ids)) ->and('post_id ' . $sql->in($ids))
->delete(); ->delete();
@ -238,7 +244,7 @@ class Utils
/** /**
* Get posts related to periods. * Get posts related to periods.
* *
* @param array<string, mixed>|ArrayObject<string, mixed> $params Parameters * @param array|ArrayObject $params Parameters
* @param bool $count_only Only counts results * @param bool $count_only Only counts results
* @param SelectStatement $ext_sql Optional SelectStatement instance * @param SelectStatement $ext_sql Optional SelectStatement instance
* *
@ -269,14 +275,14 @@ class Utils
->join( ->join(
(new JoinStatement()) (new JoinStatement())
->left() ->left()
->from($sql->as(App::con()->prefix() . App::meta()::META_TABLE_NAME, 'R')) ->from($sql->as(dcCore::app()->prefix . dcMeta::META_TABLE_NAME, 'R'))
->on('P.post_id = R.post_id') ->on('P.post_id = R.post_id')
->statement() ->statement()
) )
->join( ->join(
(new JoinStatement()) (new JoinStatement())
->left() ->left()
->from($sql->as(App::con()->prefix() . My::id(), 'T')) ->from($sql->as(dcCore::app()->prefix . My::id(), 'T'))
->on('CAST(T.periodical_id as char) = CAST(R.meta_id as char)') ->on('CAST(T.periodical_id as char) = CAST(R.meta_id as char)')
->statement() ->statement()
) )
@ -297,7 +303,7 @@ class Utils
$sql->and('T.periodical_id ' . $sql->in($params['periodical_id'])); $sql->and('T.periodical_id ' . $sql->in($params['periodical_id']));
unset($params['periodical_id']); unset($params['periodical_id']);
} }
if (App::auth()->check(App::auth()->makePermissions([App::auth()::PERMISSION_ADMIN]), App::blog()->id())) { if (dcCore::app()->auth?->check(dcCore::app()->auth->makePermissions([dcCore::app()->auth::PERMISSION_ADMIN]), dcCore::app()->blog?->id)) {
if (isset($params['post_status'])) { if (isset($params['post_status'])) {
if ($params['post_status'] != '') { if ($params['post_status'] != '') {
$sql->and('P.post_status = ' . (int) $params['post_status']); $sql->and('P.post_status = ' . (int) $params['post_status']);
@ -305,10 +311,12 @@ class Utils
unset($params['post_status']); unset($params['post_status']);
} }
} else { } else {
$sql->and('P.post_status = ' . App::blog()::POST_PENDING); $sql->and('P.post_status = ' . dcBlog::POST_PENDING);
} }
return App::blog()->getPosts($params, $count_only, $sql); $rs = dcCore::app()->blog?->getPosts($params, $count_only, $sql);
return is_null($rs) ? MetaRecord::newFromArray([]) : $rs;
} }
/** /**
@ -329,17 +337,17 @@ class Utils
return; return;
} }
$cur = App::meta()->openMetaCursor(); $cur = dcCore::app()->con->openCursor(dcCore::app()->prefix . dcMeta::META_TABLE_NAME);
App::con()->writeLock(App::con()->prefix() . App::meta()::META_TABLE_NAME); dcCore::app()->con->writeLock(dcCore::app()->prefix . dcMeta::META_TABLE_NAME);
try { try {
$cur->setField('post_id', $post_id); $cur->setField('post_id', $post_id);
$cur->setField('meta_id', $period_id); $cur->setField('meta_id', $period_id);
$cur->setField('meta_type', My::id()); $cur->setField('meta_type', My::id());
$cur->insert(); $cur->insert();
App::con()->unlock(); dcCore::app()->con->unlock();
} catch (Exception $e) { } catch (Exception $e) {
App::con()->unlock(); dcCore::app()->con->unlock();
throw $e; throw $e;
} }
@ -353,7 +361,7 @@ class Utils
public static function delPost(int $post_id): void public static function delPost(int $post_id): void
{ {
$sql = new DeleteStatement(); $sql = new DeleteStatement();
$sql->from(App::con()->prefix() . App::meta()::META_TABLE_NAME) $sql->from(dcCore::app()->prefix . dcMeta::META_TABLE_NAME)
->where('meta_type = ' . $sql->quote(My::id())) ->where('meta_type = ' . $sql->quote(My::id()))
->and('post_id = ' . $post_id) ->and('post_id = ' . $post_id)
->delete(); ->delete();
@ -366,10 +374,10 @@ class Utils
*/ */
public static function cleanPosts(?int $period_id = null): void public static function cleanPosts(?int $period_id = null): void
{ {
// hack post status of App::blog()->getPost() // hack post status of dcBlog::getPost()
$params = [ $params = [
'post_status' => '', 'post_status' => '',
'sql' => 'AND post_status != ' . App::blog()::POST_PENDING . ' ', 'sql' => 'AND post_status != ' . dcBlog::POST_PENDING . ' ',
]; ];
if ($period_id !== null) { if ($period_id !== null) {
$params['periodical_id'] = $period_id; $params['periodical_id'] = $period_id;
@ -386,7 +394,7 @@ class Utils
} }
$sql = new DeleteStatement(); $sql = new DeleteStatement();
$sql->from(App::con()->prefix() . App::meta()::META_TABLE_NAME) $sql->from(dcCore::app()->prefix . dcMeta::META_TABLE_NAME)
->where('meta_type = ' . $sql->quote(My::id())) ->where('meta_type = ' . $sql->quote(My::id()))
->and('post_id ' . $sql->in($ids)) ->and('post_id ' . $sql->in($ids))
->delete(); ->delete();
@ -401,14 +409,14 @@ class Utils
{ {
try { try {
# Cache writable ? # Cache writable ?
if (!is_writable(App::config()->cacheRoot())) { if (!is_writable(DC_TPL_CACHE)) {
throw new Exception("Can't write in cache fodler"); throw new Exception("Can't write in cache fodler");
} }
# Set file path # Set file path
$f_md5 = md5(App::blog()->id()); $f_md5 = md5((string) dcCore::app()->blog?->id);
$file = sprintf( $file = sprintf(
'%s/%s/%s/%s/%s.txt', '%s/%s/%s/%s/%s.txt',
App::config()->cacheRoot(), DC_TPL_CACHE,
My::id(), My::id(),
substr($f_md5, 0, 2), substr($f_md5, 0, 2),
substr($f_md5, 2, 2), substr($f_md5, 2, 2),