Extensions:World Expansion
| Description | Adds some worldbuilding functionality to LK sites |
|---|---|
| Author(s) | Preimpression |
| Status | testing |
| Github | worldExpansion |
| LK Version | Unspecified |
| Contains a Migration | |
Referred to in-site as World Expanded.
World Expansion adds the following to Lorekeeper:
- Locations (and Types)
- Events (and Categories)
- Figures (and Categories)
- Fauna (and Categories)
- Flora (and Categories)
Contents
Installation
- Pull the branch and fix and conflicts manually.
- Migrate to add tables with the command:
php artisan migrate - Add site settings and world page with the command:
php artisan add-world-expansion
Configuration
If you want to add more Display Styles for locations, they are housed in the Location model.
To edit the main World page (found at site.com/world/info), you may edit it at the same place as regular Pages. If you remove the page with the key world, the page will break.
Settings
There are three settings in the Site Settings that will need to be toggled in order to:
- Allow users to have locations attached as their homes
- Allow characters to have locations attached as their homes
- Set time limits to how often users can change their own home locations
Display of Associated Things
Most of the associated parts (items, locations, etc) on individual pages have commented-out versions that are the thumbnails of the various items/locations/etc.
Usage
Notice: If you delete any categories, the things within those categories will be deleted.
In order to create locations, you will need to add a location type. Once the following are created, you will be able to attach or add:
- Locations: Specialized Styles (such as Island of Man vs Man Island)
- Events: Figures and Locations
- Figures: Items
- Fauna: Items and Locations
- Flora: Items and Locations
Frequently Asked Questions
Is this on the `develop` branch?
Not yet. It should work just as well, though - on my live site I am on the develop branch and use World Expansion and there are no issues.
When will this be updated to the develop branch?
Eventually.
Does everything need a category to create?
Yes. I'll be adding that in to the admin panel text with the update to the develop branch.
I don't want to use Categories for XYZ
They're required by the extension, so my suggestion is to create one category, such as "Event" or "Location" and simply use that for all of your events or locations.
I want to link more things, like characters to figures, etc
You'll need to do several things. For this reason, unless multiple sites want a particular link added, I'll leave this up to you.
- Create a migration for a table to link many-to-many
- Create a model for this new link
- Edit the controller, service, and form to include this new link (Look at existing links)
- Edit the existing models to have Relations to the new Model you created
- Edit the blades to show the newly linked things.
I'm possibly missing some important things, but if you look at the existing links you should be able to figure them out!
Troubleshooting
No errors are currently known - if you find any issues, let me know on the Discord! (Uri#2154)
See Also
Extensions:Page_Categories by Juni also has Lore Pages, which are awesome!
