max-warnings: 0
rules:
property-sort-order:
- - 1
- -
- order: 'concentric'
+ - 0
+# Sort order rule does not work with CSS variables: https://github.com/sasstools/sass-lint/issues/1161
+# - 1
+# -
+# order: 'concentric'
no-important:
- 0
no-vendor-prefixes:
# User plugin configuration
plugins/*/config.php
+plugins/default_colors/default_colors.css
# HTML documentation
doc/html/
- 734 ArthurHoaro <arthur@hoa.ro>
- 400 VirtualTam <virtualtam@flibidi.net>
- 215 nodiscc <nodiscc@gmail.com>
+ 769 ArthurHoaro <arthur@hoa.ro>
+ 401 VirtualTam <virtualtam@flibidi.net>
+ 216 nodiscc <nodiscc@gmail.com>
56 Sébastien Sauvage <sebsauvage@sebsauvage.net>
15 Florian Eula <eula.florian@gmail.com>
13 Emilien Klein <emilien@klein.st>
+ 13 Luce Carević <lcarevic@access42.net>
12 Nicolas Danelon <hi@nicolasmd.com.ar>
9 Willi Eggeling <thewilli@gmail.com>
8 Christophe HENRY <christophe.henry@sbgodin.fr>
- 7 Luce Carević <lcarevic@access42.net>
6 B. van Berkum <dev@dotmpe.com>
6 llune <llune@users.noreply.github.com>
5 Lucas Cimon <lucas.cimon@gmail.com>
4 Alexandre Alapetite <alexandre@alapetite.fr>
4 David Sferruzza <david.sferruzza@gmail.com>
4 Immánuel Fodor <immanuelfactor+github@gmail.com>
+ 3 Agurato <mail.vmonot@gmail.com>
3 Teromene <teromene@teromene.fr>
2 Alexandre G.-Raymond <alex@ndre.gr>
2 Chris Kuethe <chris.kuethe@gmail.com>
1 Mark Gerarts <mark.gerarts@gmail.com>
1 Marsup <marsup@gmail.com>
1 Neros <contact@neros.fr>
+ 1 Rajat Hans <rajathans9@gmail.com>
1 Sbgodin <Sbgodin@users.noreply.github.com>
1 TsT <tst2005@gmail.com>
1 dimtion <zizou.xena@gmail.com>
The format is based on [Keep a Changelog](http://keepachangelog.com/)
and this project adheres to [Semantic Versioning](http://semver.org/).
+## [v0.11.0](https://github.com/shaarli/Shaarli/releases/tag/v0.11.0) - 2019-07-27
+
+**Shaarli no longer officially support PHP 5.6 and PHP 7.0 as they've reached end of life.**
+
+**Shaarli classes now use namespace, third party plugins need to update.**
+
+### Added
+- Add optional PHP extension to composer suggestions.
+- composer: enforce PHP security advisories
+- phpDocumentor configuration and make target
+- Run unit tests against PHP 7.3
+- Bunch of accessibility improvements to the default template, thanks to @llune
+- Bulk actions: set visibility
+- Display sticky label in linklist
+- Add print CSS rules to the default template
+- New setting to automatically retrieve description for new bookmarks
+- Plugin to override default template colors
+
+### Changed
+- Shaarli now uses namespaces for its classes.
+- Rewrite IP ban management
+- Default template: slightly lighten visited link color
+- Hide select all button on mobile view
+- Switch from FontAwesome v4.x to ForkAwesome
+- Daily - display the current day instead of the previous one
+
+### Fixed
+- Do not check the IP address with session protection disabled
+- API: update test regexes to comply with PCRE2
+- Optimize and cleanup imports
+- ensure HTML tags are stripped from OpenGraph description
+- Documentation invalid links
+- Thumbnails disabling if PHP GD is not installed
+- Warning if links sticky status isn't set
+- Fix button overlapping on mobile in linklist
+- Do not try to retrieve thumbnails for internal link
+- Update node-sass to fix a vulnerability in node tar dependency
+- armhf Dockerfile
+- Default template: Responsive issue with delete button fix
+- Persist sticky status on bookmark update
+
+### Removed
+- Doxygen configuration
+- redirector setting
+- QRCode link to an external service
## [v0.10.4](https://github.com/shaarli/Shaarli/releases/tag/v0.10.4) - 2019-04-16
### Fixed
_Shaarli is a minimalist link sharing service that you can install on your own server._
_It is designed to be personal (single-user), fast and handy._
-[![](https://img.shields.io/badge/stable-v0.9.7-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.9.7)
+[![](https://img.shields.io/badge/stable-v0.10.4-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.10.4)
[![](https://img.shields.io/travis/shaarli/Shaarli/stable.svg?label=stable)](https://travis-ci.org/shaarli/Shaarli)
•
-[![](https://img.shields.io/badge/latest-v0.10.4-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.10.4)
+[![](https://img.shields.io/badge/latest-v0.11.0-blue.svg)](https://github.com/shaarli/Shaarli/releases/tag/v0.11.0)
[![](https://img.shields.io/travis/shaarli/Shaarli/latest.svg?label=latest)](https://travis-ci.org/shaarli/Shaarli)
•
[![](https://img.shields.io/badge/master-v0.11.x-blue.svg)](https://github.com/shaarli/Shaarli)
$form-input-border: #d8d8d8;
$form-input-background: #eee;
+:root {
+ --main-color: #{$main-green};
+ --background-color: #{$background-color};
+ --dark-main-color: #{$dark-green};
+}
+
// General
body {
- background: $background-color;
+ background: var(--background-color);
}
.strong {
}
.pure-alert-success {
- background-color: $main-green;
+ background-color: var(--main-color);
}
.pure-alert-warning {
top: 0;
transition: max-height .5s;
z-index: 999;
- background: $main-green;
+ background: var(--main-color);
width: 100%;
// Hack to transition with auto height: http://stackoverflow.com/a/8331169/1484919
max-height: 45px;
button {
border: 0;
border-radius: 2px;
- background-color: $main-green;
+ background-color: var(--main-color);
padding: 4px 8px 6px;
color: $almost-white;
}
.search-tagcloud {
button {
&:hover {
- color: $background-color;
+ color: var(--background-color);
}
}
}
position: fixed;
visibility: hidden;
z-index: 999;
- background: $main-green;
+ background: var(--main-color);
padding: 5px 0;
width: 100%;
height: 30px;
margin: 0 0 5px;
border: 1px solid $almost-white;
border-radius: 2px;
- background: $main-green;
+ background: var(--main-color);
padding: 4px 0;
width: 100px;
height: 28px;
&:hover {
background: $almost-white;
- color: $main-green;
+ color: var(--main-color);
}
}
}
.filter-on {
- background: $main-green;
+ background: var(--main-color);
color: $light-green;
}
&:visited {
.linklist-link {
- color: $dark-green;
+ color: var(--dark-main-color);
}
}
}
.linklist-link {
- color: $main-green;
+ color: var(--main-color);
font-size: 1.1em;
&:hover {
a {
text-decoration: none;
- color: $main-green;
+ color: var(--main-color);
&:hover {
color: $dark-grey;
}
&:visited {
- color: $dark-green;
+ color: var(--dark-main-color);
}
}
}
&::before {
display: block;
margin: 10px auto;
- background: linear-gradient(to right, $background-color, $dark-grey, $background-color);
+ background: linear-gradient(to right, var(--background-color), $dark-grey, var(--background-color));
width: 80%;
height: 1px;
content: '';
margin: 15px 5px;
border: 0;
box-shadow: 1px 1px 1px $form-input-border, -1px -1px 6px $form-input-border, -1px 1px 2px $form-input-border, 1px -1px 2px $form-input-border;
- background: $main-green;
+ background: var(--main-color);
min-width: 150px;
height: 35px;
vertical-align: center;
padding: 10px 0;
width: 100%;
text-align: center;
- color: $main-green;
+ color: var(--main-color);
}
.window-subtitle {
a {
text-decoration: none;
- color: $main-green;
+ color: var(--main-color);
font-weight: bold;
&.button {
.page-form {
.submit-buttons {
.button {
- display: block;
margin: auto;
}
}
.pure-button {
&:hover {
- background-color: $main-green;
+ background-color: var(--main-color);
background-image: none;
color: $almost-white;
}
}
.validate-rename-tag {
- color: $main-green;
+ color: var(--main-color);
}
}
&::after {
display: block;
margin: 10px auto;
- background: linear-gradient(to right, $background-color, $dark-grey, $background-color);
+ background: linear-gradient(to right, var(--background-color), $dark-grey, var(--background-color));
width: 90%;
height: 1px;
content: '';
.daily-entry-description {
a {
text-decoration: none;
- color: $main-green;
+ color: var(--main-color);
&:hover {
text-shadow: 1px 1px $background-linklist-info;
}
&:visited {
- color: $dark-green;
+ color: var(--dark-main-color);
}
}
}
}
.pure-button-shaarli {
- background-color: $main-green;
+ background-color: var(--main-color);
}
.progressbar {
border-radius: 6px;
- background-color: $main-green;
+ background-color: var(--main-color);
padding: 1px;
> div {
-45deg,
$almost-white,
$almost-white 6px,
- $background-color 6px,
- $background-color 12px
+ var(--background-color) 6px,
+ var(--background-color) 12px
);
width: 0%;
height: 10px;
| [render_feed](#render_feed) | Allow to do add tags in RSS and ATOM feeds. |
| [save_link](#save_link) | Allow to alter the link being saved in the datastore. |
| [delete_link](#delete_link) | Allow to do an action before a link is deleted from the datastore. |
+| [save_plugin_parameters](#save_plugin_parameters) | Allow to manipulate plugin parameters before they're saved. |
- created
- updated
+
+#### save_plugin_parameters
+
+Triggered when the plugin parameters are saved from the plugin administration page.
+
+Plugins can perform an action every times their settings are updated.
+For example it is used to update the CSS file of the `default_colors` plugins.
+
+##### Data
+
+`$data` input contains the `$_POST` array.
+
+So if the plugin has a parameter called `MYPLUGIN_PARAMETER`,
+the array will contain an entry with `MYPLUGIN_PARAMETER` as a key.
+
+
## Guide for template designer
### Plugin administration
* `addlink-toolbar`: Adds the addlink input on the linklist page
* `archiveorg`: For each link, add an Archive.org icon
+ * `default_colors`: Override default theme colors.
+ * `isso`: Let visitor comment your shaares on permalinks with Isso.
* [`markdown`](https://github.com/shaarli/Shaarli/blob/master/plugins/markdown/README.md): Render shaare description with Markdown syntax.
+ * `piwik`: A plugin that adds Piwik tracking code to Shaarli pages.
* [`playvideos`](https://github.com/shaarli/Shaarli/blob/master/plugins/playvideos/README.md): Add a button in the toolbar allowing to watch all videos.
+ * `pubsubhubbub`: Enable PubSubHubbub feed publishing
* `qrcode`: For each link, add a QRCode icon.
* [`wallabag`](https://github.com/shaarli/Shaarli/blob/master/plugins/wallabag/README.md): For each link, add a Wallabag icon to save it in your instance.
msgid ""
msgstr ""
"Project-Id-Version: Shaarli\n"
-"POT-Creation-Date: 2019-07-06 12:14+0200\n"
-"PO-Revision-Date: 2019-07-06 12:17+0200\n"
+"POT-Creation-Date: 2019-07-13 10:45+0200\n"
+"PO-Revision-Date: 2019-07-13 10:49+0200\n"
"Last-Translator: \n"
"Language-Team: Shaarli\n"
"Language: fr_FR\n"
#: index.php:1424
msgid "Invalid link ID provided"
-msgstr ""
+msgstr "ID du lien non valide"
#: index.php:1444 tmp/export.b91ef64efc3688266305ea9b42e5017e.rtpl.php:65
msgid "Export"
msgid "Plugin administration"
msgstr "Administration des plugins"
-#: index.php:1615 tmp/thumbnails.b91ef64efc3688266305ea9b42e5017e.rtpl.php:14
+#: index.php:1616 tmp/thumbnails.b91ef64efc3688266305ea9b42e5017e.rtpl.php:14
msgid "Thumbnails update"
msgstr "Mise à jour des miniatures"
-#: index.php:1781
+#: index.php:1782
msgid "Search: "
msgstr "Recherche : "
-#: index.php:1824
+#: index.php:1825
#, php-format
msgid ""
"<pre>Sessions do not seem to work correctly on your server.<br>Make sure the "
"des cookies. Nous vous recommandons d'accéder à votre serveur depuis son "
"adresse IP ou un <em>Fully Qualified Domain Name</em>.<br>"
-#: index.php:1834
+#: index.php:1835
msgid "Click to try again."
msgstr "Cliquer ici pour réessayer."
msgid "For each link, add an Archive.org icon."
msgstr "Pour chaque lien, ajoute une icône pour Archive.org."
-#: plugins/demo_plugin/demo_plugin.php:465
+#: plugins/default_colors/default_colors.php:33
+msgid ""
+"Default colors plugin error: This plugin is active and no custom color is "
+"configured."
+msgstr ""
+"Erreur du plugin default colors : ce plugin est actif et aucune couleur "
+"n'est configurée."
+
+#: plugins/default_colors/default_colors.php:107
+msgid "Override default theme colors. Use any CSS valid color."
+msgstr ""
+"Remplacer les couleurs du thème par défaut. Utiliser n'importe quelle "
+"couleur CSS valide."
+
+#: plugins/default_colors/default_colors.php:108
+msgid "Main color (navbar green)"
+msgstr "Couleur principale (vert de la barre de navigation)"
+
+#: plugins/default_colors/default_colors.php:109
+msgid "Background color (light grey)"
+msgstr "Couleur de fond (gris léger)"
+
+#: plugins/default_colors/default_colors.php:110
+msgid "Dark main color (e.g. visited links)"
+msgstr "Couleur principale sombre (ex : les liens visités)"
+
+#: plugins/demo_plugin/demo_plugin.php:482
msgid ""
"A demo plugin covering all use cases for template designers and plugin "
"developers."
"Une extension de démonstration couvrant tous les cas d'utilisation pour les "
"designers de thèmes et les développeurs d'extensions."
+#: plugins/demo_plugin/demo_plugin.php:483
+msgid "This is a parameter dedicated to the demo plugin. It'll be suffixed."
+msgstr "Ceci est un paramètre dédié au plugin de démo. Il sera suffixé."
+
+#: plugins/demo_plugin/demo_plugin.php:484
+msgid "Other demo parameter"
+msgstr "Un autre paramètre de démo"
+
#: plugins/isso/isso.php:22
msgid ""
"Isso plugin error: Please define the \"ISSO_SERVER\" setting in the plugin "
"miniatures."
#: tmp/configure.90100d2eaf5d3705e14b9b4f78ecddc9.rtpl.php:162
-#| msgid "Enable thumbnails"
msgid "Synchonize thumbnails"
-msgstr ""
+msgstr "Synchroniser les miniatures"
#: tmp/configure.b91ef64efc3688266305ea9b42e5017e.rtpl.php:29
msgid "title"
// lf_id should only be present if the link exists.
$id = isset($_POST['lf_id']) ? intval(escape($_POST['lf_id'])) : $LINKSDB->getNextId();
+ $link['id'] = $id;
// Linkdate is kept here to:
// - use the same permalink for notes as they're displayed when creating them
// - let users hack creation date of their posts
// See: https://shaarli.readthedocs.io/en/master/guides/various-hacks/#changing-the-timestamp-for-a-shaare
$linkdate = escape($_POST['lf_linkdate']);
+ $link['created'] = DateTime::createFromFormat(LinkDB::LINK_DATE_FORMAT, $linkdate);
if (isset($LINKSDB[$id])) {
// Edit
- $created = DateTime::createFromFormat(LinkDB::LINK_DATE_FORMAT, $linkdate);
- $updated = new DateTime();
- $shortUrl = $LINKSDB[$id]['shorturl'];
+ $link['updated'] = new DateTime();
+ $link['shorturl'] = $LINKSDB[$id]['shorturl'];
+ $link['sticky'] = isset($LINKSDB[$id]['sticky']) ? $LINKSDB[$id]['sticky'] : false;
$new = false;
} else {
// New link
- $created = DateTime::createFromFormat(LinkDB::LINK_DATE_FORMAT, $linkdate);
- $updated = null;
- $shortUrl = link_small_hash($created, $id);
+ $link['updated'] = null;
+ $link['shorturl'] = link_small_hash($link['created'], $id);
+ $link['sticky'] = false;
$new = true;
}
}
$url = whitelist_protocols(trim($_POST['lf_url']), $conf->get('security.allowed_protocols'));
- $link = array(
- 'id' => $id,
+ $link = array_merge($link, [
'title' => trim($_POST['lf_title']),
'url' => $url,
'description' => $_POST['lf_description'],
'private' => (isset($_POST['lf_private']) ? 1 : 0),
- 'created' => $created,
- 'updated' => $updated,
'tags' => str_replace(',', ' ', $tags),
- 'shorturl' => $shortUrl,
- );
+ ]);
// If title is empty, use the URL as title.
if ($link['title'] == '') {
$link['thumbnail'] = $thumbnailer->get($url);
}
- $link['sticky'] = isset($link['sticky']) ? $link['sticky'] : false;
-
$pluginManager->executeHooks('save_link', $link);
$LINKSDB[$id] = $link;
if ($targetPage == Router::$PAGE_SAVE_PLUGINSADMIN) {
try {
if (isset($_POST['parameters_form'])) {
+ $pluginManager->executeHooks('save_plugin_parameters', $_POST);
unset($_POST['parameters_form']);
foreach ($_POST as $param => $value) {
$conf->set('plugins.'. $param, escape($value));
--- /dev/null
+:root {
+%s
+}
--- /dev/null
+description="Override default theme colors. Use any CSS valid color."
+parameters="DEFAULT_COLORS_MAIN;DEFAULT_COLORS_BACKGROUND;DEFAULT_COLORS_DARK_MAIN"
+parameter.DEFAULT_COLORS_MAIN="Main color (navbar green)"
+parameter.DEFAULT_COLORS_BACKGROUND="Background color (light grey)"
+parameter.DEFAULT_COLORS_DARK_MAIN="Dark main color (e.g. visited links)"
--- /dev/null
+<?php
+
+/**
+ * Plugin default_colors.
+ *
+ * Allow users to easily overrides colors of the default theme.
+ */
+
+use Shaarli\Config\ConfigManager;
+use Shaarli\Plugin\PluginManager;
+
+const DEFAULT_COLORS_PLACEHOLDERS = [
+ 'DEFAULT_COLORS_MAIN',
+ 'DEFAULT_COLORS_BACKGROUND',
+ 'DEFAULT_COLORS_DARK_MAIN',
+];
+
+/**
+ * Display an error if the plugin is active a no color is configured.
+ *
+ * @param $conf ConfigManager instance
+ *
+ * @return array|null The errors array or null of there is none.
+ */
+function default_colors_init($conf)
+{
+ $params = '';
+ foreach (DEFAULT_COLORS_PLACEHOLDERS as $placeholder) {
+ $params .= trim($conf->get('plugins.'. $placeholder, ''));
+ }
+
+ if (empty($params)) {
+ $error = t('Default colors plugin error: '.
+ 'This plugin is active and no custom color is configured.');
+ return array($error);
+ }
+}
+
+/**
+ * When plugin parameters are saved, we regenerate the custom CSS file with provided settings.
+ *
+ * @param array $data $_POST array
+ *
+ * @return array Updated $_POST array
+ */
+function hook_default_colors_save_plugin_parameters($data)
+{
+ $file = PluginManager::$PLUGINS_PATH . '/default_colors/default_colors.css';
+ $template = file_get_contents(PluginManager::$PLUGINS_PATH . '/default_colors/default_colors.css.template');
+ $content = '';
+ foreach (DEFAULT_COLORS_PLACEHOLDERS as $rule) {
+ $content .= ! empty($data[$rule])
+ ? default_colors_format_css_rule($data, $rule) .';'. PHP_EOL
+ : '';
+ }
+
+ if (! empty($content)) {
+ file_put_contents($file, sprintf($template, $content));
+ }
+
+ return $data;
+}
+
+/**
+ * When linklist is displayed, include default_colors CSS file.
+ *
+ * @param array $data - header data.
+ *
+ * @return mixed - header data with default_colors CSS file added.
+ */
+function hook_default_colors_render_includes($data)
+{
+ $file = PluginManager::$PLUGINS_PATH . '/default_colors/default_colors.css';
+ if (file_exists($file )) {
+ $data['css_files'][] = $file ;
+ }
+
+ return $data;
+}
+
+/**
+ * Create a valid CSS rule from parameters settings and plugin parameter.
+ *
+ * @param array $data $_POST array
+ * @param string $parameter Plugin parameter name
+ *
+ * @return string CSS rules for the provided parameter and its matching value.
+ */
+function default_colors_format_css_rule($data, $parameter)
+{
+ if (empty($data[$parameter])) {
+ return '';
+ }
+
+ $key = str_replace('DEFAULT_COLORS_', '', $parameter);
+ $key = str_replace('_', '-', strtolower($key)) .'-color';
+ return ' --'. $key .': '. $data[$parameter];
+}
+
+
+/**
+ * This function is never called, but contains translation calls for GNU gettext extraction.
+ */
+function default_colors_translation()
+{
+ // meta
+ t('Override default theme colors. Use any CSS valid color.');
+ t('Main color (navbar green)');
+ t('Background color (light grey)');
+ t('Dark main color (e.g. visited links)');
+}
description="A demo plugin covering all use cases for template designers and plugin developers."
+parameters="DEMO_PLUGIN_PARAMETER;DEMO_PLUGIN_OTHER_PARAMETER"
+parameter.DEMO_PLUGIN_PARAMETER="This is a parameter dedicated to the demo plugin. It'll be suffixed."
+parameter.DEMO_PLUGIN_OTHER_PARAMETER="Other demo parameter"
return $data;
}
+/**
+ * When plugin parameters are saved.
+ *
+ * @param array $data $_POST array
+ *
+ * @return array Updated $_POST array
+ */
+function hook_demo_plugin_save_plugin_parameters($data)
+{
+ // Here we edit the provided value, but we can use this to generate config files, etc.
+ if (! empty($data['DEMO_PLUGIN_PARAMETER']) && ! endsWith($data['DEMO_PLUGIN_PARAMETER'], '_SUFFIX')) {
+ $data['DEMO_PLUGIN_PARAMETER'] .= '_SUFFIX';
+ }
+
+ return $data;
+}
+
/**
* This function is never called, but contains translation calls for GNU gettext extraction.
*/
{
// meta
t('A demo plugin covering all use cases for template designers and plugin developers.');
+ t('This is a parameter dedicated to the demo plugin. It\'ll be suffixed.');
+ t('Other demo parameter');
}
--- /dev/null
+<?php
+
+namespace Shaarli\Plugin\DefaultColors;
+
+use DateTime;
+use PHPUnit\Framework\TestCase;
+use Shaarli\Bookmark\LinkDB;
+use Shaarli\Config\ConfigManager;
+use Shaarli\Plugin\PluginManager;
+
+require_once 'plugins/default_colors/default_colors.php';
+
+/**
+ * Class PluginDefaultColorsTest
+ *
+ * Test the DefaultColors plugin (allowing to override default template colors).
+ */
+class PluginDefaultColorsTest extends TestCase
+{
+ /**
+ * Reset plugin path
+ */
+ public function setUp()
+ {
+ PluginManager::$PLUGINS_PATH = 'sandbox';
+ mkdir(PluginManager::$PLUGINS_PATH . '/default_colors/');
+ copy(
+ 'plugins/default_colors/default_colors.css.template',
+ PluginManager::$PLUGINS_PATH . '/default_colors/default_colors.css.template'
+ );
+ }
+
+ /**
+ * Remove sandbox files and folder
+ */
+ public function tearDown()
+ {
+ if (file_exists('sandbox/default_colors/default_colors.css.template')) {
+ unlink('sandbox/default_colors/default_colors.css.template');
+ }
+
+ if (file_exists('sandbox/default_colors/default_colors.css')) {
+ unlink('sandbox/default_colors/default_colors.css');
+ }
+
+ if (is_dir('sandbox/default_colors')) {
+ rmdir('sandbox/default_colors');
+ }
+ }
+
+ /**
+ * Test DefaultColors init without errors.
+ */
+ public function testDefaultColorsInitNoError()
+ {
+ $conf = new ConfigManager('');
+ $conf->set('plugins.DEFAULT_COLORS_BACKGROUND', 'value');
+ $errors = default_colors_init($conf);
+ $this->assertEmpty($errors);
+ }
+
+ /**
+ * Test DefaultColors init with errors.
+ */
+ public function testDefaultColorsInitError()
+ {
+ $conf = new ConfigManager('');
+ $errors = default_colors_init($conf);
+ $this->assertNotEmpty($errors);
+ }
+
+ /**
+ * Test the save plugin parameters hook with all colors specified.
+ */
+ public function testSavePluginParametersAll()
+ {
+ $post = [
+ 'other1' => true,
+ 'DEFAULT_COLORS_MAIN' => 'blue',
+ 'DEFAULT_COLORS_BACKGROUND' => 'pink',
+ 'other2' => ['yep'],
+ 'DEFAULT_COLORS_DARK_MAIN' => 'green',
+ ];
+
+ hook_default_colors_save_plugin_parameters($post);
+ $this->assertFileExists($file = 'sandbox/default_colors/default_colors.css');
+ $content = file_get_contents($file);
+ $expected = ':root {
+ --main-color: blue;
+ --background-color: pink;
+ --dark-main-color: green;
+
+}
+';
+ $this->assertEquals($expected, $content);
+ }
+
+ /**
+ * Test the save plugin parameters hook with only one color specified.
+ */
+ public function testSavePluginParametersSingle()
+ {
+ $post = [
+ 'other1' => true,
+ 'DEFAULT_COLORS_BACKGROUND' => 'pink',
+ 'other2' => ['yep'],
+ 'DEFAULT_COLORS_DARK_MAIN' => '',
+ ];
+
+ hook_default_colors_save_plugin_parameters($post);
+ $this->assertFileExists($file = 'sandbox/default_colors/default_colors.css');
+ $content = file_get_contents($file);
+ $expected = ':root {
+ --background-color: pink;
+
+}
+';
+ $this->assertEquals($expected, $content);
+ }
+
+ /**
+ * Test the save plugin parameters hook with no color specified.
+ */
+ public function testSavePluginParametersNone()
+ {
+ hook_default_colors_save_plugin_parameters([]);
+ $this->assertFileNotExists($file = 'sandbox/default_colors/default_colors.css');
+ }
+
+ /**
+ * Make sure that the CSS is properly included by the include hook.
+ */
+ public function testIncludeWithFile()
+ {
+ $data = [
+ 'css_files' => ['file1'],
+ 'js_files' => ['file2'],
+ ];
+ touch($file = 'sandbox/default_colors/default_colors.css');
+ $processedData = hook_default_colors_render_includes($data);
+
+ $this->assertCount(2, $processedData['css_files']);
+ $this->assertEquals($file, $processedData['css_files'][1]);
+ $this->assertCount(1, $processedData['js_files']);
+ }
+
+ /**
+ * Make sure that the CSS is not included by the include hook if the CSS file does not exist.
+ */
+ public function testIncludeWithoutFile()
+ {
+ $data = [
+ 'css_files' => ['file1'],
+ 'js_files' => ['file2'],
+ ];
+ $processedData = hook_default_colors_render_includes($data);
+
+ $this->assertEquals($data, $processedData);
+ }
+
+ /**
+ * Test helper function which generates CSS rules with valid input.
+ */
+ public function testFormatCssRuleValid()
+ {
+ $data = [
+ 'other1' => true,
+ 'DEFAULT_COLORS_BLIP_BLOP' => 'shinyColor',
+ 'other2' => ['yep'],
+ ];
+ $result = default_colors_format_css_rule($data, 'DEFAULT_COLORS_BLIP_BLOP');
+ $this->assertEquals(' --blip-blop-color: shinyColor', $result);
+
+ $data = ['unknown-parameter' => true];
+ $result = default_colors_format_css_rule($data, 'unknown-parameter');
+ $this->assertEquals(' --unknown-parameter-color: 1', $result);
+ }
+
+ /**
+ * Test helper function which generates CSS rules with invalid input.
+ */
+ public function testFormatCssRuleInvalid()
+ {
+ $result = default_colors_format_css_rule([], 'DEFAULT_COLORS_BLIP_BLOP');
+ $this->assertEmpty($result);
+
+ $data = [
+ 'other1' => true,
+ 'DEFAULT_COLORS_BLIP_BLOP' => 'shinyColor',
+ 'other2' => ['yep'],
+ ];
+ $result = default_colors_format_css_rule($data, '');
+ $this->assertEmpty($result);
+ }
+}