Candela (DEPRECATED)
Candela is a book authoring platform built on top of Wordpress Multisite and
Pressbooks. This project is no longer maintained and may not function as
expected; however, the plugins this project uses are still used and maintained, and can be found below:
Candela Utility: Candela helper plugin to manage additional config and bootstrapping
Candela Citation: A plugin that extends creative commons attribution functionality to Candela/Pressbooks
Candela Thin Exports: A simple plugin to export Pressbooks books as thin cartridges with deep links to each page
Candela LTI: A plugin that implements the LTI/Wordpress integration
Candela Outcomes: A plugin that adds an Outcomes meta field for coursework
Bombadil Theme: A Wordpress Theme based on the Pressbooks Luther Theme
Install Wordpress
The following instructions assume basic familiarity with installing Wordpress, and that this codebase is located in a web accessible location.
- Navigate to your installed base.
- Click "Create a Configuration File"
- Click "Let's go!"
- DB Connection details;
- Database Name:
******
- User Name:
******
- Password:
******
- Database Host:
localhost
- Table Prefix:
wp_
- Click "Run the install"
- Welcome
- Site Title:
Candela
- Username:
******
- Password:
******
- Email:
******
-
Edit wp-config.php and add the following just above the line /* That's all, stop editing! Happy blogging. */
;
/* Multisite */
define( 'WP_ALLOW_MULTISITE', true );
/* Pressbooks configuration */
define( 'PB_PRINCE_COMMAND', '/usr/bin/prince' );
define( 'PB_KINDLEGEN_COMMAND', '/home/vagrant/kindlegen/kindlegen' );
define( 'PB_EPUBCHECK_COMMAND', '/usr/bin/java -jar /home/vagrant/epubcheck-3.0.1/epubcheck-3.0.1.jar' );
define( 'PB_XMLLINT_COMMAND', '/usr/bin/xmllint' );
- Click "Log in"
- Login with details just created.
- Tools -> Network Setup
- Choose 'sub-directories'
- Click "Install"
- Follow on screen instructions making appropriate edits to
wp-config.php
and .htaccess
Enable and Configure Pressbooks and Pressbooks Textbooks
- Once above edits are made relogin
- Navigate to "My Sites" -> "Network Admin" -> "Plugins"
- "Network Activate" Pressbooks
- "Network Activate" Disable Comments
- "Network Activate" Candela Analytics
- "Network Activate" Candela Citations
- "Network Activate" Candela Links
- "Network Activate" Candela Utility
- Use the "Settings" link for Disable Comments to access the settings page. Select "Everywhere: Disable all comment-related controls and settings in WordPress." Click the "Save Changes" button.
- Navigate to "My Catalog" -> "Network Admin" -> "Themes"
- Select "Installed Themes"
- "Network Enable" the "Candela" theme
- Navigate to "My Catalog" -> "Network Admin" -> "Dashboard"
- Select "Settings" -> "Network Settings"
- In the "Allow new registrations" section, select: "Logged in users may register new sites." This allows members with adequate privileges to create their own books
- the other options on this page should be set/adjusted to suit administrative needs/preference
- Navigate to "My Catalog" -> "Add a New Book"
- Get writing!
Hypothes.is
The hypothes.is functionality is included as part of Pressbooks Textbooks and needs to be enabled on a book by book basis. To enable annotation in your books:
- Navigate to "PB Textbook" admin section in the book where you want to enable Hypothes.is;
- Click the "Other" tab;
- Select "Yes. I would like to add annotation functionality to my book pages."
- Click the "Save Changes" button.
Enable and configure LTI and candela LTI
- Navigate to "My Catalog" -> "PRIMARY SITE NAME" -> "Dashboard"
- Click "Plugins"
- "Activate" LTI
- Navigate to "My Sites" -> "Network Admin" -> "Plugins"
- "Network Activate" Candela LTI
- In the left admin menu (primary site only), navigate to "LTI Consumers" -> "Add New."