Difference between revisions of "Extensions:Design Terms"

From Lorekeeper Wiki
Jump to navigation Jump to search
(Create Extensions:Design Terms Page)
Tag: 2017 source edit
 
m
Tag: 2017 source edit
 
(7 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=Design Terms|desc=add custom user terms and commercial permissions|auth=AnimatedCritter|status=stable|github={{Github|user=AnimatedCritter|branch=extension/design-terms}}|LKVer=2.1.0|migration=yes|package=no}}This extension allows users to add their own design terms to the site! Depending on how you set you site up, this can be through an external url, written on-site (similar to user profiles), or both! This also includes an additional "commercial rights" field, although due to the nature of these permissions, are editable only by staff.
<!-- Put a short summary of your extension here! -->
 
 
== Installation ==
 
== Installation ==
<!-- Describe installation. Include any requirements (such as packages), necessary commands, etc. -->
+
Pull and merge the branch, making sure to address any merge issues.
 +
 
 +
Afterwards, run the following commands in your console:
 +
 
 +
<code>php artisan migrate</code>
 +
 
 +
<code>php artisan populate-user-terms</code> - fills in extension data for pre-exsisting users
 +
 
 +
<code>php artisan add-site-settings</code>
 +
 
 +
<code>php artisan update-extension-tracker</code>
 
== Configuration ==
 
== Configuration ==
<!-- Is any configuration necessary? Describe it here! -->
+
This extension has two (2) site settings: <code>commercial_permissions_visible</code> and <code>external_terms</code>.
 +
 
 +
<code>commercial_permissions_visible</code>
 +
* Determines if users can see commercial permissions -- basically an "enable/disable" setting.
 +
* Enabled by default, but can be changed in site settings from the admin panel.
 +
* If you have the setting disabled, you can always change it.
 +
** Any characters made while the feature was disabled will have their has_commercial_permissions set to false. Each instance must be manually changed via the "Edit Character Stats" panel.
 +
 
 +
<code>external_terms</code>
 +
* Determines if users can upload an external link for their terms, and if a disclaimer is displayed before the redirect.
 +
* By default, external links are enabled, but with a disclaimer.
 +
 
 +
In addition to the site settings, there is also a disclaimer displayed on the character's "Terms" tab. If you want to change this message, you will have to manually go into <code>resources/views/character/_tab_terms.blade.php</code> to change it. The same case applies to user settings and <code>resources/views/account/settings.blade.php</code>.
 
== Usage ==
 
== Usage ==
<!-- Is there anything users should know about using your extension? -->
+
Users are able to edit their own terms at any point through the account settings page. If the user selects to "Notify Owners of These Changes", the owners of their designs will receive a notification about an update. (It does not show *what* changes are made, though.)
 +
 
 +
Meanwhile, commercial permissions are not able to be edited by users; updating this setting is the responsibility of the mod team/admin. These permissions can be updated via the "Edit Character Stats" panel.
 
== Troubleshooting ==
 
== Troubleshooting ==
<!-- Are there known issues or errors that require user action? Who should they contact, and where, for support? -->
+
I am no longer on Discord. Instead, please contact me through CritterCodes (https://crittercodes.neocities.org/). Thank you!
 +
 
 +
'''Potential Issues & Solutions:'''
 +
 
 +
<code>SQLSTATE[42S02]: Base table or view not found</code> when running <code>php artisan populate-user-terms</code>
 +
* Populate-user-terms must be run after <code>php artisan migrate</code> has been run successfully, since migrate creates the user-terms table it populates.
 
== Images ==
 
== Images ==
<!-- Do you have any images to show what it looks like in action? -->
+
[[File:Screenshot 2022-09-29 020902.png|none|thumb]]
== See Also ==
 
<!-- Any relevant other pages. You may consider linking to related extensions, for instance. -->
 
 
 

Latest revision as of 16:58, 28 January 2024

Design Terms
Description add custom user terms and commercial permissions
Author(s) AnimatedCritter
Status stable
Github extension/design-terms
LK Version 2.1.0
Contains a Migration





This extension allows users to add their own design terms to the site! Depending on how you set you site up, this can be through an external url, written on-site (similar to user profiles), or both! This also includes an additional "commercial rights" field, although due to the nature of these permissions, are editable only by staff.

Installation

Pull and merge the branch, making sure to address any merge issues.

Afterwards, run the following commands in your console:

php artisan migrate

php artisan populate-user-terms - fills in extension data for pre-exsisting users

php artisan add-site-settings

php artisan update-extension-tracker

Configuration

This extension has two (2) site settings: commercial_permissions_visible and external_terms.

commercial_permissions_visible

  • Determines if users can see commercial permissions -- basically an "enable/disable" setting.
  • Enabled by default, but can be changed in site settings from the admin panel.
  • If you have the setting disabled, you can always change it.
    • Any characters made while the feature was disabled will have their has_commercial_permissions set to false. Each instance must be manually changed via the "Edit Character Stats" panel.

external_terms

  • Determines if users can upload an external link for their terms, and if a disclaimer is displayed before the redirect.
  • By default, external links are enabled, but with a disclaimer.

In addition to the site settings, there is also a disclaimer displayed on the character's "Terms" tab. If you want to change this message, you will have to manually go into resources/views/character/_tab_terms.blade.php to change it. The same case applies to user settings and resources/views/account/settings.blade.php.

Usage

Users are able to edit their own terms at any point through the account settings page. If the user selects to "Notify Owners of These Changes", the owners of their designs will receive a notification about an update. (It does not show *what* changes are made, though.)

Meanwhile, commercial permissions are not able to be edited by users; updating this setting is the responsibility of the mod team/admin. These permissions can be updated via the "Edit Character Stats" panel.

Troubleshooting

I am no longer on Discord. Instead, please contact me through CritterCodes (https://crittercodes.neocities.org/). Thank you!

Potential Issues & Solutions:

SQLSTATE[42S02]: Base table or view not found when running php artisan populate-user-terms

  • Populate-user-terms must be run after php artisan migrate has been run successfully, since migrate creates the user-terms table it populates.

Images

Screenshot 2022-09-29 020902.png