Skip to content

lumenlearning/candela

Repository files navigation

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.

  1. Navigate to your installed base.
  2. Click "Create a Configuration File"
  3. Click "Let's go!"
  4. DB Connection details;
  • Database Name: ******
  • User Name: ******
  • Password: ******
  • Database Host: localhost
  • Table Prefix: wp_
  1. Click "Run the install"
  2. Welcome
  • Site Title: Candela
  • Username: ******
  • Password: ******
  • Email: ******
  1. 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' );
  1. Click "Log in"
  2. Login with details just created.
  3. Tools -> Network Setup
  4. Choose 'sub-directories'
  5. Click "Install"
  6. Follow on screen instructions making appropriate edits to wp-config.php and .htaccess

Enable and Configure Pressbooks and Pressbooks Textbooks

  1. Once above edits are made relogin
  2. Navigate to "My Sites" -> "Network Admin" -> "Plugins"
  3. "Network Activate" Pressbooks
  4. "Network Activate" Disable Comments
  5. "Network Activate" Candela Analytics
  6. "Network Activate" Candela Citations
  7. "Network Activate" Candela Links
  8. "Network Activate" Candela Utility
  9. 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.
  10. Navigate to "My Catalog" -> "Network Admin" -> "Themes"
  11. Select "Installed Themes"
  12. "Network Enable" the "Candela" theme
  13. Navigate to "My Catalog" -> "Network Admin" -> "Dashboard"
  14. Select "Settings" -> "Network Settings"
  15. 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
  1. Navigate to "My Catalog" -> "Add a New Book"
  2. 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:

  1. Navigate to "PB Textbook" admin section in the book where you want to enable Hypothes.is;
  2. Click the "Other" tab;
  3. Select "Yes. I would like to add annotation functionality to my book pages."
  4. Click the "Save Changes" button.

Enable and configure LTI and candela LTI

  1. Navigate to "My Catalog" -> "PRIMARY SITE NAME" -> "Dashboard"
  2. Click "Plugins"
  3. "Activate" LTI
  4. Navigate to "My Sites" -> "Network Admin" -> "Plugins"
  5. "Network Activate" Candela LTI
  6. In the left admin menu (primary site only), navigate to "LTI Consumers" -> "Add New."