Organizer – Website How To Guide

Work in Progress

Category Listings

This page is reached by clicking the "Categories" section of the main menu:

 

This shows you a page of all categories you have access to.  The page lists:

  1. Publish? - Whether it will be published or not.
  2. Name - Name of the category (click this field to edit the category)
  3. Accepted - How many ads were created and how many are accepted.  (Only accepted ads appear and are charged for).
  4. Start Date - Date when the category first appears on the website.
  5. Finish Date - Last date the category appears on the website (it is removed the day after this date).
  6. Kiosk Close Date - Last date (at midnight) when the kiosk stops selling tokens.
  7. Listing Fee - How much it costs to list.
  8. Amount Paid - How much was paid.

Edit Category

Once you select a category to edit, you will get a page that is broken down into several sections:

Title and Import/Export

This area tells you about the category and provides controls for importing an exporting.

  1. Importing allows you to load up avatars and stores with a bulk importer.  You need to include store names in your import, because Marvelous Mania supports multiple brands per designer, and store name is the only way to differentiate one brand from another.  The import window is described here.
  2. Exporting allows you to see the category in 4 different ways.  To pick the method of export, select it from the drop-down, then click Go:
    1. HTML is used most of the time, and this is used to generate the webpage for the category, and you use this feature most of the time.
    2. CSV is used to see all of the advertisements in the category in a format that can be edited by spreadsheet programs.  While we could export Microsoft Excel (XLSX) files, we decided to use CSV so that you do not have to deal with unblocking the file in order to edit it.
    3. Stats is used to collect all of the statistics for all tokens in the category.  These stats are the Impression and Engagement events on both the HUD and website.
    4. HUD is used if you want to get the export needed for the HUD.  Contact support to learn how to use this feature.

 


Reference Information (use "+" to open/close section)

Reference Information are details about the category that are maintained by the Marvelous Mania System's Administration.  There are a lot of fields here:

  1. Name of Category (for reference, but it can be edited below).
  2. Code and Secret - These two fields are needed to authorize objects in world.
    1. Category Code - Each category is assigned an internal code that uniquely identifies it.
    2. Authorized Secret - Is a 40-50 characters password for the Category.  It's impossible to guess.
  3. Administrators - Shows the names of people who have access to edit the category and UUIDs of people without a designer profile.  Click the link to open the profile in second life.
  4. (Not Shown) Recurring Date / Advances By - Is how recurring categories are replicated.  Replication can occur weekly, bi weekly, monthly, bi-monthly and a host of other options.  The way it works is when the recurring date occurs, we create a duplicate category with all of the same settings, but with new dates.  Those dates are incremented by the "Advances By" value.
  5. Pricing - Is used to show you all of the cost information for the category.
    1. Token Wholesale Price - is how much we charge you to list a single item.  Values are daily or a combination of 1 or more weeks.  Such as "L$45 per 3 weeks".
    2. Count of 'Accepted' Advertisements - We only charge for advertisements with an 'Accepted' state.  To understand states, see below.
    3. Current Actual Cost - Wholesale Price multiplied by Accepted advertisements.
    4. Cumulative Fee - The cost that is calculated daily or by event.
    5. Amount Paid - Amount paid to date.  If the difference between these two numbers varies by too much, the category stops being published until accounts are settled.
  6. Webpage Name - Is the name of the webpage on our website: https://admin.mm4sl.info/ListedAds/{WEBPAGE-NAME}.html
  7. CSSName - Is the CSS file that is used to format a webpage.  In 2019, this part will change to provide more flexible formatting.

What does the CSS do?

The CSS (Cascading Style Sheet) is a HTML technology that provides color and styling information to a web site page.  It is possible to change the styling with our own layout, however, in 2019, we will build an interface for this.  With CSS styling turned on, this is what the page looks like:


But if you remove the CSS reference, the same page looks like this:


Standard Category Settings

This section deals with the general category settings.  There are a lot of fields:

  1. Name of Category - Name of the category as it appears on the website. For recurring events a date is added to the end of the category name:
    1. For monthly events, it's the month and year of the event.  i.e. "Marvelous Hunts - June 2019".
    2. For weekly events, it's the date of the start date.  i.e. "Jan 2, 19".
    3. Note, you will notice as you change the name that the copy of this field further up the page also updates.
  2. Category External Website - The website associated with your event, this can be any URL.  Leave blank if you don't have one.
  3. Category Default SLURL - The default SLURL for the category.  It's used to:
    1. Provide a default SLURL for advertisements in the category.
    2. Forces the designers in your category to specify a location that is fixed to the same region as your event.
    3. You use an SLURL for events to identify where a resident goes, by default, when going to an ad. If it is removed, then designers can specify the Item's SLURL anywhere on the grid.
  4. Category Texture UUID - The picture that appears on the website for the category as well as on the HUD to identify the category.  This is required even if you are running a Custom Marvelous Mania HUD.
  5. Start / Finish Date - Dates the category first appears, and the last date the it appears on the website indexes and HUD.  You can still access the webpage after the Finish Date, but it won't be automatically updated past the Finish Date.
  6. Unassigned Group Label - This is the header that appears for submissions that do not have a tag assigned (see tags below).  Those submissions appear at the bottom of the category.  When it's blank, no header appears.
  7. General Options:
    1. Auto Approve
      1. When ON, advertisements are set to "Accepted" when they are changed on the website by the designer.
      2. When OFF, advertisements are set to "Registered" when they are changed on the website by the designer.
    2. Publish on MM Website?
      1. When ON, the category appears on our website index.
      2. When OFF, the category appears on our website index.
      3. Note: This should be left ON when using a Custom Marvelous Mania HUD, as it will publish the content to your own index website.
  8. Sort Method - Defines how to order the advertisements.  It's always by group, then:
    1. by Store Name - the alphabetical order by store/brand name.
    2. by Order Added - the order the advertisements were created.
    3. by Last Update - the order they were last updated.
  9. Max Category Items - Maximum Items allowed in the category.  You use this when you want to limit the maximum number of advertisements sold with a kiosk.
  10. Maximum Advertisement Tokens / Person - Maximum advertising tokens are allowed per user.  (values 1 to 100).  Generally used by the kiosk.
  11. HUD:
    1. HUD Category Type Name - Name of the category on the HUD.  (Yellow arrow)
    2. HUD Name/Plural - How a single or plural name is shown on the HUD (Green arrow).  Name is used when there is only one advertisement in the category.

 

Webpage Header Content

When the web page is created, it creates a header that tells people about your event.  The coloring, sizes and positioning of these fields are entirely controlled by the event's CSS file:

  1. Category Texture UUID
  2. Name of Category
  3. Category External Website
  4. Category Type (internally set by Marvelous Mania)
  5. Dates (these might not appear if the category never expires)

Token Sales Kiosk Settings

Identifies settings for sales kiosks or other special needs).

  1. Cost / Token - Identifies the cost of the tokens on the kiosk, can be 0 to 9999; where 0 is free.
  2. 'Group' Members Only? - When ON, only individuals in the same group as what is assigned to the kiosk can buy or get tokens from it.
  3. Close Date - This is the date the kiosk will stop providing tokens (it stops at midnight on this date).
  4. Details for 3rd Parties - Information about your category that a person might want to know.  The kiosk has an Info Button, and this is what is shown in that field.
  5. Publicly Listed? - Does the event appear on our Open Categories Listing.
  6. Kiosk SLURL - This is the location of the kiosk or a URL to where people can apply to be part of your category.  (If you use Google Forms instead of the kiosk)

Advanced Category Settings

These are largely internal settings that further control the category.  Remember to specify the values in 'English' as translations occur from an English name:

  1. User Defined Price - When ON, the designer will be able to identify the price for the item, and it will appear on the website and HUD.
  2. Fixed Item Price - When non-zero, all items in the category will have a fixed price.
  3. HUD's price is shown as 'n/a' - When ON, the HUD price is shown as 'n/a'.
  4. Item Label / Comment Label - Label that appears for the item name in your category.  Usually the default is fine, but for events that use brands, you might want to use the fi
  5. Location Label - Appears for the item.  For events, item location is fine, but for sales the location should be "Item Position" and hunts "Store Location".

Save Area

Any changes you make to any fields above have to be saved.


Advertisements

This area allows you to manage the advertisements that are associated with your category.  There are several clickable areas:

  1. Tags - Allows you to edit tags associated with your event.
  2. Create Advertisement - Creates a single advertisement (described below).  Creating advertisements is a two stage process.  One creates the ad, the second is editing the ad.
  3. Preview - Shows this ad on a preview screen.
  4. Show SL Profile - Shows the Second Life Profile of the Designer (by opening the link to their profile in your viewer).
  5. Show MM Profile - Shows details about a Designer's Profile on Marvelous Mania.
  6. Edit Item - Edit the contents of the advertisement.
  7. Copy JPEG Location to Clipboard - Copies our external link to a JPEG version of the designer's image, so that it can be used in social media.

Create and Editing Advertisement

To manage advertisements in your category you select the Item Name, currently called "TBD", to open the editor.

Once in the editor you can edit all of these fields.  Only the top section is required, as you are generally creating advertisements for others, not for yourself.

  1. Token Code - This is an internal code used for tracking and authorization purposes.
  2. Submission State - Identifies the state you are assigning to the submission.  Other documentation describes these values.
    1. Created - Most of the time you will create advertisements with a submission state of created.  In this state, designers can drop textures into our drop boxes and have them associated when the status is "Created".  Created also tells you if anybody has edited the advertisement space you have provided for them.
  3. Owner Username - This is the name of the user who will own the token.
  4. Group? - This is used to organize advertisements.
  5. Store Name - Name of the store used in this advertisement.  It's use during a save to select the correct brand.
  6. Use Designer Profile? - When ON, uses the designers profile.
  7. {Item Name} - Name of the item being advertised.  The reason it is enclosed in {curly brackets} is because the text of this label is set on the Event Page, and may be different for you.
  8. {Features/Price} - Comment about the brand or item, including it's features or price.  The reason it is enclosed in {curly brackets} is because the text of this label is set on the Event Page, and may be different for you.
  9. Item Texture - The UUID of the texture to use for the advertisement.
  10. Image - A visual copy of the texture for that UUID.
  11. {Item Location} - Location of the starting point where the item being advertised.  The reason it is enclosed in {curly brackets} is because the text of this label is set on the Event Page, and may be different for you.
  12. Additional Comments - Up to 500 characters to provide additional information about your brand or item, etc.
  13. Save, Cancel and Delete -
    • Saves the changes
    • Cancels them and closes the popup.
    • Delete removes the submission.  If you are looking to remove a lot of advertisements in the "Created" state, then use the Purge function on the Category Detail page (that's where you go when you click "Cancel").

Understanding Submission States

We support 4 states for our advertisements.

  1. Created - The initial state of the advertisement.  An advertisement must have a created state in order to match against textures added to the texture dropbox.  This approach ensures that only residents who are authorized (via a Created advertisement) to submit textures.
  2. Registered - This state is used for:
    1. When "Auto Approve" is turned OFF, then any changes to an advertisement get a state of registered whenever a designer changes any details about the advertisement.
    2. When an advertisement is "Unlisted" it is set to this state to prevent it from appearing on the website.
    3. For the CasperLet Availability Monitor - This state is set when a tenant rents your property.
    4. For the CasperLet Advertisement Provider - This state is set when a tenant leaves your property.
  3. Issue - This state occurs when an advertisement has some kind of issue.  When you set the state, you get a 50 character field to describe the problem.  (In the future, a user will get a daily notification that there is an issue they need to address.)
  4. Accepted - This means the advertisement can be published.


Groups

Groups where added in 2019, and allow organizers to divide their advertisements up into collections, which we call groups.  Groups have other features, including the ability to have multiple kiosks selling different group advertisements based on price.  Advertisements appear grouped by these labels in the order shown.  Larger sort indexes are shown first.

Details.  The screen is very self explanatory (and can be translated into 100+ languages):

Import Window

Importing is discussed in detail on this page.