Difference between revisions of "Extensions:World Expansion"

From Lorekeeper Wiki
Jump to navigation Jump to search
Tag: 2017 source edit
Tag: 2017 source edit
Line 65: Line 65:
 
# Edit the existing models to have Relations to the new Model you created
 
# Edit the existing models to have Relations to the new Model you created
 
# Edit the blades to show the newly linked things.
 
# 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 ==
 
== Troubleshooting ==

Revision as of 09:52, 7 March 2021

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)

Installation

  1. Pull the branch and fix and conflicts manually.
  2. Migrate to add tables with the command: php artisan migrate
  3. 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.

  1. Create a migration for a table to link many-to-many
  2. Create a model for this new link
  3. Edit the controller, service, and form to include this new link (Look at existing links)
  4. Edit the existing models to have Relations to the new Model you created
  5. 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!