Thanks for your patience during our recent outage at scalar.usc.edu. While Scalar content is loading normally now, saving is still slow, and Scalar's 'additional metadata' features have been disabled, which may interfere with features like timelines and maps that depend on metadata. This also means that saving a page or media item will remove its additional metadata. If this occurs, you can use the 'All versions' link at the bottom of the page to restore the earlier version. We are continuing to troubleshoot, and will provide further updates as needed. Note that this only affects Scalar projects at scalar.usc.edu, and not those hosted elsewhere.
Scalar 2 User's GuideMain MenuGetting StartedExplains account and book creation, and some interface basics.QuickStartsA path of all QuickStart content in this user's guide.Working with MediaHow to get the most out of your use of media in Scalar.Working with ContentCreating and editing content in Scalar.Working with WidgetsWorking with StructureHow to use Scalar's many options for structuring publications.Editorial WorkflowHow to use features for performing editorial review of content.VisualizationsExploring the contents of a book visually.LensesAn introduction to lenses, a tool for searching and visualizing Scalar content.Advanced TopicsDescribing Scalar's more advanced features.Third Party Plugins and Platforms
Managing a custom Scalar install with local_settings.php
12017-07-30T10:06:55-07:00Craig Dietrich2d66800a3e5a1eaee3a9ca2f91f391c8a689349032963Description of the features that a customizable in the local settings config file.plain2017-07-30T10:19:44-07:00Craig Dietrich2d66800a3e5a1eaee3a9ca2f91f391c8a6893490If you're running your own installation of Scalar, you should have access to the core Scalar system files on your server either via FTP or another file management system. For example, you might be running Scalar on your own server or utilizing Reclaim Hosting (which includes Scalar as a single-click install). Either way, you'll want to take notice of the configuration file that is meant to be customized per-install, called local_settings.php. It contains fields for things like a Google Maps API key and a Scalar registration key which you will need to add if you wish to "turn on" these features. The config file is kept at:
You can open this file in your FTP client, or download to your computer, edit, and overwrite back to the server. Comments in the file will describe what each config item controls. If, for example, you wish to have a Scalar registration key for your Scalar install so that folks need the key in order to register new accounts, you would change this:
// Register key (leave blank if no register key required, e.g., array()) // One of the strings placed in this array will be required in order for new users to register $config['register_key'] = array();
... to this:
// Register key (leave blank if no register key required, e.g., array()) // One of the strings placed in this array will be required in order for new users to register $config['register_key'] = array('my key');
Another practical example is the Google Maps API key. This key will need to be present for Scalar's Google Maps Layout and Widget to work, otherwise you'll get an error message from Google when loading a page in that layout or widget. You can acquire your own API key about halfway down on Google's Google Maps APIs page.
This page has paths:
1media/scalar-rdf-controller-node-method.PNG2014-10-01T16:38:30-07:00Erik Loyerf862727c4b34febd6a0341bffd27f168a35aa637Advanced TopicsCurtis Fletcher35Describing Scalar's more advanced features.image_header2021-02-24T09:45:06-08:00Curtis Fletcher3225f3b99ebb95ebd811595627293f68f680673e