gorriecoe / silverstripe-webfonts
Provide webfont integration for SilverStripe CMS.
Installs: 971
Dependents: 1
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 1
Open Issues: 1
Type:silverstripe-vendormodule
Requires
- silverstripe/framework: ^4.0.2
README
Provide webfonts integration for SilverStripe CMS allowing fonts inside HTMLEditorField and frontend.
Requirements
- silverstripe/framework ^4.0
Installation
Composer is the recommended way of installing SilverStripe modules.
$ composer require gorriecoe/silverstripe-webfonts
Documentation
TypeKit
Define the TypeKitID in config.yaml
gorriecoe\Webfonts\View\Webfonts:
TypeKitID: '######'
One of the following can be used in page template:
$TypeKitScript
: Returns javascript embed code.$TypeKitStyle
: Returns style link code.$TypeKitID
: Returns the Typekit kit ID.$WebFontLoader
: Returns web font loader embed code.
Example
<head> <title>Example.com</title> {$TypeKitScript} </head>
Google Fonts
Define the GoogleFonts in config.yaml
gorriecoe\Webfonts\View\Webfonts:
GoogleFonts:
- 'Droid Sans'
- 'Droid Serif:bold'
One of the following can be used in page template:
$GoogleFonts
: Returns style link code.$WebFontLoader
: Returns web font loader embed code.
Example
<head> <title>Example.com</title> {$GoogleFonts} </head>
Fonts.com
Define the FontsComID in config.yaml
gorriecoe\Webfonts\View\Webfonts:
FontsComID: '######'
One of the following can be used in page template:
$FontsCom
: Returns javascript link code.$FontsComID
: Returns the Font.com project ID.$WebFontLoader
: Returns web font loader embed code.
Example
<head> <title>Example.com</title> {$FontsCom} </head>
Multiple font providers
Define the options as listed above in config.yaml
gorriecoe\Webfonts\View\Webfonts:
TypeKitID: '######'
GoogleFonts:
- 'Droid Sans'
- 'Droid Serif:bold'
$WebFontLoader
returns web font loader embed code is the recommended variable used in page template for handling multiple font providers.
Example
<head> <title>Example.com</title> {$WebFontLoader} </head>
Custom Fonts
Define the CustomFonts in config.yaml
gorriecoe\Webfonts\View\Webfonts:
CustomFonts:
'MyFont:Bold,Italic': '/fonts.css'
'FontAwesome': '//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.css'
$WebFontLoader
can be used in page template to return web font loader embed code.