Rapi::Blog - Plack-compatible, RapidApp-based blog engine
use Rapi::Blog; my $app = Rapi::Blog->new({ site_path => '/path/to/some-site', scaffold_path => '/path/to/some-site/scaffold', # default }); # Plack/PSGI app: $app->to_app
Create a new site from scratch using the rabl.pl utility script:
rabl.pl create /path/to/some-site cd /path/to/some-site && plackup
This is a Plack-compatible blogging platform written using RapidApp. This module was first released during The Perl Conference 2017 in Washington D.C. where a talk/demo was given on the platform:
rapi.io/tpc2017
See Rapi::Blog::Manual for more information and usage.
Rapi::Blog extends RapidApp::Builder and supports all of its options, as well as the following params specific to this module:
Rapi::Blog
Only required param - path to the directory containing the site.
Path to the directory containing the "scaffold" of the site. This is like a document root with some extra functionality.
If not supplied, defaults to 'scaffold/' within the site_path directory.
'scaffold/'
site_path
Alternative to scaffold_path, the name of one of the builtin skeleton scaffolds to use as the live scaffold. This is mainly useful for dev and content-only testing. As of version 1.0000) there are two built-in scaffolds:
scaffold_path
1.0000
This is the default out-of-the-box scaffold which is based on the "Blog" example from the Twitter Bootstrap HTML/CSS framework (v3.3.7): http://getbootstrap.com/examples/blog/. This mainly exists to serve as a useful reference implementation of the basic features/directives provided by the Template API.
Based on the "Keep It Simple" website template by http://www.Styleshout.com
If set to true and the local scaffold directory doesn't exist, the default builtin skeleton scaffold 'bootstrap-blog' will be used instead. Useful for testing and content-only scenarios.
Defaults to false.
Optional HashRef of Email::Sender::Transport::SMTP params which will be used by the app for sending E-Mails, such as password resets and other notifications. The options are passed directly to Email::Sender::Transport::SMTP-new()>. If the special param transport_class is included, it will be used as the transport class instead of Email::Sender::Transport::SMTP. If this is supplied, it should still be a valid Email::Sender::Transport class.
Email::Sender::Transport::SMTP-
transport_class
Email::Sender::Transport::SMTP
If this option is not supplied, E-Mails will be sent via the localhost using sendmail via the default Email::Sender::Transport::Sendmail options.
sendmail
If set, all e-mails generated by the system will be sent to the specified address instead of normal recipients.
Optional HashRef config to enable Google reCAPTCHA v2 validation on supported forms. An account and API key pair must be setup with Google first. This config supports the following params:
Required. The public, or "SITE KEY" provided by the Google reCAPTCHA settings, after being setup in the Google reCAPTCHA system www.google.com/recaptcha/admin
Required. The private, or "SECRET KEY" provided by the Google reCAPTCHA settings, after being setup in the Google reCAPTCHA system www.google.com/recaptcha/admin. Both the public_key and the private_key are provided as a pair and both are required.
public_key
private_key
Optional URL to use when performing the actual reCAPCTHA validation with Google. Defaults to https://www.google.com/recaptcha/api/siteverify which should probably never need to be changed.
https://www.google.com/recaptcha/api/siteverify
Optional mode (turned off by default) which can be enabled to tighten the enforcement reCAPTCHA, requiring it in all locations which is is setup on the server side, regardless of whether or not the client form is actually prompting the user with the appropriate reCAPTCHA "I am not a robot" checkbox dialog. In those cases of client-side forms not properly setup, they will never be able to submit because they will always fail reCAPTCHA validation.
When this mode is off (the default) reCAPTCHA validation is only performed when both the client and the server are properly setup. The downside of this is that it leaves open the scenario of a spammer direct posting to the server instead of using the actual form. Whether or not this mode should be used should be based on need -- if spammers exploit this, turn it on. Otherwise, it is best to leave it off as it turning it on has the potential to make the site less resilient and reliable.
This param accepts only 2 possible values: 1 (enabled) or 0 (disabled, which is the default).
PSGI $app CodeRef. Derives from Plack::Component
$app
rabl.pl
Rapi::Blog::Manual
RapidApp
RapidApp::Builder
Plack
http://rapi.io/blog
Henry Van Styn <vanstyn@cpan.org>
This software is copyright (c) 2017 by IntelliTree Solutions llc.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Rapi::Blog, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Rapi::Blog
CPAN shell
perl -MCPAN -e shell install Rapi::Blog
For more information on module installation, please visit the detailed CPAN module installation guide.