Themes can be accessed via the panel in weaverFM's preferences and are the recommended way to style the login panel to match your site.
Finding themes
Themes are currently available from:
Installing themes
The recommended way to install themes is via the RWAddonsInstaller.
The RWAddonsInstaller will automatically copy over the following assets to their proper location:
- weaverFM themes Files/Folders that end in .wfmtheme.
- Stacks Files/Folders that end in .Stack.
- RapidAlbum bundles Files that end in .bundle.
- RapidWeaver plugins Files that end in .rwplugin.
Applying a theme
To apply a theme simply hit the 'Apply theme' button. The currently selected theme will be denoted with a icon in the theme list.
The theme attributes include:
- Name The name of the theme.
- Version The version of the theme.
- Author The author of the theme.
- Keywords Keywords for the theme.
- Website The website for the author of the theme.
- Styles A collection of various styles of the theme.
Deleting a theme
Themes will have to be deleted manually. Please be sure to quit RapidWeaver BEFORE deleting any themes. All installed themes can be found in ~/Application Support/RapidWeaver/weaverFM/Themes/.
Creating a theme
If you are interested in creating your own themes, I highly recommend starting with a pre-made theme. Feel free to use the built-in theme as a starting point for your design. The default theme is available inside weaverFM (Right click -> View Package Contents).
The following Info.plist keys are currently available:
- WFMThemeAssets An array listing all of the assets that are required for the theme.
- WFMThemeStylesheet The name of the stylesheet to use for the theme.
- WFMThemeAPI The minimum API that the theme supports.
- WFMThemeStyles A dictionary of alternate styles that the theme supports and their associated stylesheets.
- WFMThemeKeywords Keywords that help describe the theme.
- WFMThemeAuthor The author of the theme.
- WFMThemeName The name of the theme.
- WFMThemeURL The homepage for the theme.
- WFMThemeVersion The version of the theme.
- WFMThemeEscape A string value (Yes or No) indicating if the Esc key should hide the theme. This is good for modal based themes.
- WFMThemeTransition The transition to use when showing and hiding the theme. Possible values are: sine:in:out, bounce:in:out, or quad:in:out. Default: sine:in:out.
- WFMThemeDuration The duration of the transition. Possible values are: short, normal, or long. Default: short
|