Difference between revisions of "Extensions:World Expansion"
Tag: 2017 source edit |
(Added Mercury's update - Concepts and Factions) Tag: 2017 source edit |
||
| Line 1: | Line 1: | ||
| − | {{Extensioninfobox|title=World Expansion|desc=Adds some worldbuilding functionality to LK sites|auth=Preimpression|status=testing|github={{Github|user=preimpression|branch= | + | {{Extensioninfobox|title=World Expansion|desc=Adds some worldbuilding functionality to LK sites|auth=Preimpression|status=testing|github={{Github|user=preimpression|branch=extension/world-expansion}}|migration=yes|package=no}} |
<!-- Put a short summary of your extension here! --> | <!-- Put a short summary of your extension here! --> | ||
| Line 10: | Line 10: | ||
* Fauna (and Categories) | * Fauna (and Categories) | ||
* Flora (and Categories) | * Flora (and Categories) | ||
| + | * Concepts (and Categories) - Thanks Mercury! | ||
| + | * Factions (and Categories) - Thanks Mercury! | ||
== Installation == | == Installation == | ||
| Line 16: | Line 18: | ||
# Migrate to add tables with the command: <code>php artisan migrate</code> | # Migrate to add tables with the command: <code>php artisan migrate</code> | ||
# Add site settings and world page with the command: <code>php artisan add-world-expansion</code> | # Add site settings and world page with the command: <code>php artisan add-world-expansion</code> | ||
| + | # Add to extension tracker: <code>php artisan update-extension-tracker</code> | ||
== Configuration == | == Configuration == | ||
| Line 24: | Line 27: | ||
=== Settings === | === Settings === | ||
| − | There are | + | There are settings in the Site Settings that will need to be toggled in order to: |
* Allow users to have locations attached as their homes | * Allow users to have locations attached as their homes | ||
* Allow characters to have locations attached as their homes | * Allow characters to have locations attached as their homes | ||
| Line 38: | Line 41: | ||
In order to create '''locations''', you will need to add a location type. | 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: | Once the following are created, you will be able to attach or add: | ||
| − | * '''Locations''': Specialized Styles (such as Island of Man vs Man Island) | + | * '''Locations''': (Users/Characters) Specialized Styles (such as Island of Man vs Man Island) |
| − | * '''Events''': Figures | + | * '''Events''': Figures, Locations |
| − | * '''Figures''': Items | + | * '''Figures''': Items, Faction |
| − | * '''Fauna''': Items | + | * '''Fauna''': Items, Locations |
| − | * '''Flora''': Items | + | * '''Flora''': Items, Locations |
| + | * '''Concepts''': Items, Locations | ||
| + | * '''Factions''': (Users/Characters) Events, Figures, Locations | ||
== Frequently Asked Questions == | == Frequently Asked Questions == | ||
==== Is this on the `develop` branch? ==== | ==== Is this on the `develop` branch? ==== | ||
| − | + | Yes!, thanks to Mercury, who also added Concepts and Factions! | |
| − | |||
| − | |||
| − | |||
==== Does everything need a category to create? ==== | ==== Does everything need a category to create? ==== | ||
| − | Yes. I'll be adding that in to the admin panel text | + | Yes. I'll be adding that in to the admin panel text soon. |
==== I don't want to use Categories for XYZ ==== | ==== I don't want to use Categories for XYZ ==== | ||
Revision as of 17:32, 22 March 2021
| Description | Adds some worldbuilding functionality to LK sites |
|---|---|
| Author(s) | Preimpression |
| Status | testing |
| Github | extension/world-expansion |
| 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)
- Concepts (and Categories) - Thanks Mercury!
- Factions (and Categories) - Thanks Mercury!
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 - Add to extension tracker:
php artisan update-extension-tracker
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 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: (Users/Characters) Specialized Styles (such as Island of Man vs Man Island)
- Events: Figures, Locations
- Figures: Items, Faction
- Fauna: Items, Locations
- Flora: Items, Locations
- Concepts: Items, Locations
- Factions: (Users/Characters) Events, Figures, Locations
Frequently Asked Questions
Is this on the `develop` branch?
Yes!, thanks to Mercury, who also added Concepts and Factions!
Does everything need a category to create?
Yes. I'll be adding that in to the admin panel text soon.
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!
