Plugin Customizations
Adding your own style sheets
You can style your plugin’s pages in a distinct way by adding your own style-sheet. This happens by overwriting FlexMeasures styles
block. Add to your plugin’s base template (see above):
{% block styles %}
{{ super() }}
<!-- Our client styles -->
<link rel="stylesheet" href="{{ url_for('our_client_bp.static', filename='css/style.css')}}">
{% endblock %}
This will find css/styles.css if you add that folder and file to your Blueprint’s static folder.
Note
This styling will only apply to the pages defined in your plugin (to pages based on your own base template). To apply a styling to all other pages which are served by FlexMeasures, consider using the config setting FLEXMEASURES_EXTRA_CSS_PATH.
Adding config settings
FlexMeasures can automatically check for you if any custom config settings, which your plugin is using, are present.
This can be very useful in maintaining installations of FlexMeasures with plugins.
Config settings can be registered by setting the (optional) __settings__
attribute on your plugin module:
__settings__ = {
"MY_PLUGIN_URL": {
"description": "URL used by my plugin for x.",
"level": "error",
},
"MY_PLUGIN_TOKEN": {
"description": "Token used by my plugin for y.",
"level": "warning",
"message_if_missing": "Without this token, my plugin will not do y.",
"parse_as": str,
},
"MY_PLUGIN_COLOR": {
"description": "Color used to override the default plugin color.",
"level": "info",
},
}
Alternatively, use from my_plugin import __settings__
in your plugin module, and create __settings__.py
with:
MY_PLUGIN_URL = {
"description": "URL used by my plugin for x.",
"level": "error",
}
MY_PLUGIN_TOKEN = {
"description": "Token used by my plugin for y.",
"level": "warning",
"message_if_missing": "Without this token, my plugin will not do y.",
"parse_as": str,
}
MY_PLUGIN_COLOR = {
"description": "Color used to override the default plugin color.",
"level": "info",
}
Finally, you might want to override some FlexMeasures configuration settings from within your plugin. Some examples for possible settings are named on this page, e.g. the custom style (see above) or custom logo (see below). There is a record_once function on Blueprints which can help with this. An example:
@our_client_bp.record_once
def record_logo_path(setup_state):
setup_state.app.config[
"FLEXMEASURES_MENU_LOGO_PATH"
] = "/path/to/my/logo.svg"
Using a custom favicon icon
The favicon might be an important part of your customisation. You probably want your logo to be used.
First, your blueprint needs to know about a folder with static content (this is fairly common ― it’s also where you’d put your own CSS or JavaScript files):
our_client_bp = Blueprint(
"our_client",
"our_client",
static_folder="our_client/ui/static",
)
Put your icon file in that folder. The exact path may depend on how you set your plugin directories up, but this is how a blueprint living in its own directory could work.
Then, overwrite the /favicon.ico
route which FlexMeasures uses to get the favicon from:
from flask import send_from_directory
@our_client_bp.route("/favicon.ico")
def favicon():
return send_from_directory(
our_client_bp.static_folder,
"img/favicon.png",
mimetype="image/png",
)
Here we assume your favicon is a PNG file. You can also use a classic .ico file, then your mime type probably works best as image/x-icon
.
Validating arguments in your CLI commands with marshmallow
Arguments to CLI commands can be validated using marshmallow.
FlexMeasures is using this functionality (via the MarshmallowClickMixin
class) and also defines some custom field schemas.
We demonstrate this here, and also show how you can add your own custom field schema:
from datetime import datetime
from typing import Optional
import click
from flexmeasures.data.schemas.times import AwareDateTimeField
from flexmeasures.data.schemas.utils import MarshmallowClickMixin
from marshmallow import fields
class CLIStrField(fields.Str, MarshmallowClickMixin):
"""
String field validator, made usable for CLI functions.
You could also define your own validations here.
"""
@click.command("meet")
@click.option(
"--where",
required=True,
type=CLIStrField(),
help="(Required) Where we meet",
)
@click.option(
"--when",
required=False,
type=AwareDateTimeField(format="iso"), # FlexMeasures already made this field suitable for CLI functions
help="[Optional] When we meet (expects timezone-aware ISO 8601 datetime format)",
)
def schedule_meeting(
where: str,
when: Optional[datetime] = None,
):
print(f"Okay, see you {where} on {when}.")