Difference between revisions of "Extensions:Alternate Site Designs"

From Lorekeeper Wiki
Jump to navigation Jump to search
(Created page with "{{subst:Extension Page}}")
Tag: 2017 source edit
 
Tag: 2017 source edit
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Extensioninfobox|title=the extension's name|desc=A short description|auth=Author(s)|status=status (such as WIP, testing, stable)|github={{Github|user=username|branch=branch}}|LKVer=What Lorekeeper version the ext is built on|migration=yes/no|package=yes/no}}
+
{{Extensioninfobox|title=Alternate Site Designs|desc=Allows you to pick from a couple of predefined site designs beside default LK, as well as change the fonts styles on site to fonts within a predefined selection - all via admin panel!|status=testing|github={{Github|user=cylunny|branch=extension/alternate-site-designs}}|LKVer=2.1.7|migration=yes|package=no}}
<!-- Put a short summary of your extension here! -->
+
 
 +
Allows you to pick from a couple of predefined site designs beside default LK, as well as change the fonts styles on site to fonts within a predefined selection - all via admin panel!
 +
 
 
== Installation ==
 
== Installation ==
<!-- Describe installation. Include any requirements (such as packages), necessary commands, etc. -->
+
* pull & deal with merge conflicts
 +
* <code>php artisan migrate</code>
 +
* <code>php artisan optimize</code> x2
 +
* <code>php artisan update-extension-tracker</code>
 +
 
 
== Configuration ==
 
== Configuration ==
<!-- Is any configuration necessary? Describe it here! -->
+
Nothing should be needed, it's all editable via admin panel.
 +
 
 
== Usage ==
 
== Usage ==
<!-- Is there anything users should know about using your extension? -->
+
Once you ran all the usual commands, you should have a new section under Settings called Site Design. Go there to edit the site design! As of version 1.0.0, these site designs are included:
 +
* default
 +
* headerless
 +
* squished
 +
* full width
 +
 
 +
Because this extension only changes site layout and fonts, not colors! As such it works beautifully with the [http://wiki.lorekeeper.me/index.php?title=Extensions:Theme_Manager theme manager extension] (by Uri, moif and me). A convenience merge can be found here:
 +
https://github.com/Cylunny/lorekeeper/tree/merge/theme-manager-site-designs
 +
 
 +
 
 +
 
 +
==== Fonts ====
 +
I added a selection of fonts to use for ease of use, adding more would require some code knowledge but is not very difficult. The gist of it would be:
 +
* add a new font import in app.blade.php below ALTERNATE SITE FONTS
 +
* add the name of your new font to the $fonts array in the SiteDesignController's getIndex()function
 +
And it should work and show up as a selectable font.
 +
 
 
== Troubleshooting ==
 
== Troubleshooting ==
<!-- Are there known issues or errors that require user action? Who should they contact, and where, for support? -->
+
We are never 100% safe from those pesky bugs. If you find something, feel free to contact me- I am cylunny on discord or toyhou.se!
 
== Images ==
 
== Images ==
<!-- Do you have any images to show what it looks like in action? -->
+
See here for available designs + examples on how it can look with the theme manager extension!  
 +
https://imgur.com/a/Hwgbqlm
 
== See Also ==
 
== See Also ==
<!-- Any relevant other pages. You may consider linking to related extensions, for instance. -->
+
If this extension helped you, feel free to support me on [https://ko-fi.com/cylunny Kofi]!
 
 

Latest revision as of 22:16, 21 July 2024

Alternate Site Designs
Description Allows you to pick from a couple of predefined site designs beside default LK, as well as change the fonts styles on site to fonts within a predefined selection - all via admin panel!
Author(s) Unknown Author
Status testing
Github extension/alternate-site-designs
LK Version 2.1.7
Contains a Migration






Allows you to pick from a couple of predefined site designs beside default LK, as well as change the fonts styles on site to fonts within a predefined selection - all via admin panel!

Installation

  • pull & deal with merge conflicts
  • php artisan migrate
  • php artisan optimize x2
  • php artisan update-extension-tracker

Configuration

Nothing should be needed, it's all editable via admin panel.

Usage

Once you ran all the usual commands, you should have a new section under Settings called Site Design. Go there to edit the site design! As of version 1.0.0, these site designs are included:

  • default
  • headerless
  • squished
  • full width

Because this extension only changes site layout and fonts, not colors! As such it works beautifully with the theme manager extension (by Uri, moif and me). A convenience merge can be found here: https://github.com/Cylunny/lorekeeper/tree/merge/theme-manager-site-designs


Fonts

I added a selection of fonts to use for ease of use, adding more would require some code knowledge but is not very difficult. The gist of it would be:

  • add a new font import in app.blade.php below ALTERNATE SITE FONTS
  • add the name of your new font to the $fonts array in the SiteDesignController's getIndex()function

And it should work and show up as a selectable font.

Troubleshooting

We are never 100% safe from those pesky bugs. If you find something, feel free to contact me- I am cylunny on discord or toyhou.se!

Images

See here for available designs + examples on how it can look with the theme manager extension! https://imgur.com/a/Hwgbqlm

See Also

If this extension helped you, feel free to support me on Kofi!