CasperVend 2/Quick Start: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
 
(100 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== '''<span style="color:#00528c">Getting Started</span>''' ==
{|align=right
  |__TOC__
  |}


You can get selling with CasperVend '''FAST'''! Just follow these steps to get started..
[[File:German_flag.gif]] [[CasperVend_2/Quick_Start/DE | Dies in deutsch!]]


&nbsp;
== '''<span style="color:#00528c">Feature List</span>''' ==
:'''<big>1) Rez the included DropBox.</big>'''  


:: ''This is your "Server" and must remain rezzed inworld, since it will deliver your items. We recommend a limit of around 200 items per DropBox just to keep things from taking forever to load as you add new products.  We recommend that you have a second copy of your dropbox(es) on another sim, to provide a backup for delivery. See the [[CasperVend_2/DropBoxes | DropBoxes]] page for more details.''
Want to see the capabilities first? '''[[CasperVend_2/Feature_List | Click here.]]'''


&nbsp;
== '''<span style="color:#00528c">Create Your Products</span>''' ==
: 1) Create your products for sale. If your products are items to be rezzed (like furniture or buildings), remember to set the next-owner permissions '''while they are rezzed inworld.'''


:'''<big>2) Make sure your packaged product, the picture for it, and any notecard that goes with the product do NOT have identical names!</big>
: 2) Create the pictures to be used for your vendors and upload them to SL. <br />''(The vendors will call the image by the UUID, and there is no UUID if the image hasn't been uploaded to SL.) ''


::''Delivery works by '''NAME''', not UUID - if you have different things with identical names, it may deliver ANY of them, at random, which means your customer may get a picture or a notecard instead of your packaged product!''
: 3) Create your shipping package. You cannot use folders with CasperVend - the dropbox is only capable of sending packaged products. <br /> '' (box, bag, crate, whatever you want to be seen when your customers unpack everything.)''


:: <span style="color:#F00;">'''''IMPORTANT: This means that if your product is in multiple pieces - like a set of clothing - that you WILL need to put it in a box, bag or shipping crate. CasperVend cannot deliver a folder out of the DropBox.'''''</span>
: 4) If your items need to be rezzed anyway, simply right-click > edit > general tab > set default action to "open" on click.  


: 5) If you want your shipping package to unpack on rez (or on wearing) there are third party scripts available on Marketplace or Primbay. Remember to TEST FIRST.


&nbsp;
=== '''Why Do I Have to Upload My Images?''' ===
----


:'''<big>3) Place all of your products into the contents of your dropbox(es).</big>'''  
: '''Q. Why do I have to upload my images? Marketplace allows free uploads, why can't CasperVend do that?'''


:: ''Right click the box, go to "Edit", then the "Contents" tab. Then, simply drag the products from your inventory into the DropBox. The box will upload your items in around 30 seconds - please '''pay attention to any messages the box issues''', it will warn you if you have put items into it that you don't have permission to transfer. If you get a warning about no transfer items, please check the contents of the prims in your build for no-transfer scripts, animations, textures, notecards, etc.''
: '''A.''' The vendor scripts call the images via the image's UUID. You can only GET a UUID for an image, if the image has been uploaded to SL. Remember, Marketplace is run by Linden Lab, and it has its own "inventory servers" from which the images gets shown. That's why Marketplace images don't need to be an SL upload.


:: <span style="color:#F00;">'''''IMPORTANT: Your DropBox MUST stay rezzed, or your deliveries will fail.'''''</span>
== '''<span style="color:#00528c">Package Your Products</span>''' ==
: 1) Each product (with its respective parts) goes in '''one''' shipping package.


:: <span style="color:#F00;">'''''ALSO IMPORTANT: The DropBox CANNOT deliver a folder - you must package all the parts for each product in its own bag/box/shipping crate.'''''</span>
: 1a) This shipping package can be a bag, a crate, whatever. It '''CANNOT''' be a folder, because the DropBox cannot deliver a folder.


&nbsp;
: 2) Add any relevant notecards, landmarks, product pictures, etc. that you want the customers to have for that product into that shipping package at this time.


:'''<big>4) Place a texture (and notecard, if applicable) for each of your products into the DropBox(es).</big>'''
: 3) Make sure each product package has its own unique name.


:: ''The textures must be full perm. Ideally, these textures should contain the price, title and permissions of the item, as well as a photograph of it - but this is entirely at your discretion. Once you have the textures selected for each product, you may delete the corresponding texture from the dropbox to save space. Alternately, you may paste the UUID of the texture from inworld into the appropriate slot in the product listing. ''
: 4) Pick up your newly named shipping package(s).


:: <span style="color:#F00;">'''''IMPORTANT: Textures you set to products are viewable on the delivery status page. Please don't add any textures that you don't want people to be able to download.'''''</span>
== '''<span style="color:#00528c">Unpack CasperVend Crate & Fill Your DropBox</span>''' ==


&nbsp;
: 1) Unpack your CasperVend shipping crate.


:'''<big>5) Put your store's landmark in the DropBox</big>'''
: 2) Rez a copy of the CasperTech DropBox (the box, not the sphere).


:: ''Name your landmark something simple like '''" (your store name) - main location "''' - this way if you have to move later, you only need to replace the landmark in the dropbox, without having to update the landmark on every single product.  
: 3) Drag your product package(s) from your inventory into the "contents" tab of the DropBox.


&nbsp;
: 4) Add your store landmark - and give it a generic name, such as '''"((your store name)) - Main Location"'''.


:'''<big>6) Rez a vendor (Not the CasperVend Touch or Headless, to begin with) and grant debit permissions.</big>'''
: 5) All packages, notecards, landmarks, and any textures must ALL have unique names. This is to prevent the system from getting confused and thinking the wrong item is the product package.


:: ''These permissions are required in order for the vendor to handle money on your behalf - the vendor '''cannot''' operate without debit permissions. See the [[Debit_Permissions]] page for details.''  
: '''5) Dropboxes MUST remain rezzed inworld to deliver items!'''


&nbsp;
== '''<span style="color:#00528c">Set Up Product Listings</span>''' ==
: 1) Once everything is in, and the dropbox has finished sending data up to the website, click the DropBox and select "Admin" from the popup menu.


:'''<big>7) When the vendor has loaded, touch the "CasperVend" logo in the bottom left hand corner of the vendor.</big>'''  
: 2) Let it take you to the CasperVend website where you can '''[[Passwords_CasperVend | create your account]]''' and log in.


:: ''This will then ask to open a URL to our website - go ahead and open it up.''
: 3) Click "Products" on the left column.


&nbsp;
: 4) If you have no products set up already, the page will be empty. This is '''normal''' until you begin setting up products. (The "Products" page only shows '''completed''' listings.)


:'''<big>8) If you are new to CasperVend, please enter a secure password, otherwise, just log in.</big>'''
: 5) Click the green [[File:Listnew.png||||"List New Product"]] button


:: If necessary, you can use the [[CasperVend_2/Password_Reset#Creating_Your_CasperVend_Account | account creation]] instructions.
: 6) You will now be presented with the product setup screen for your individual product.


:: '''''<span style="color:#F00;">IMPORTANT: For your own security, please do not use the same password that you use in any other vending systems, or in Second Life.</span>'''''
: 7)  See the '''[[CasperVend_2/Product_Options | product options]]''' page for details on how to set up products.


&nbsp;
: 8) To save space in your dropbox, for each product's vendor texture, simply right-click on the texture '''in your inworld inventory,'''  select '''"copy UUID"''', and paste that in the UUID box within the product listing page.


:'''<big>9) Once you are logged in, click the large "Products" button on the left hand side, and then click "+ List New Product".</big>'''
: 9) Remember to click "save" at the bottom when you are done filling in product information.  
:: ''This is the page where you will be setting up all of your product information.''


&nbsp;
: 10) Repeat for each product you want to set up at this time.


:'''<big>10) Please fill out information on one of your products.</big>'''  
== '''<span style="color:#00528c">Sales Notifications</span>''' ==


:: ''You at least need to enter a name, price, set the permissions, and choose an Item and Texture. Everything else is optional. If you use alpha textures, the texture might not show properly on the CasperVend website - don't be concerned with this, the items will still show properly inworld.''
There is a link on the Overview tab to turn sales notifications on or off.  


::<span style="color:#F00;">'''''IMPORTANT: Take extra care to set the permissions properly for your products - particularly if they're no copy. We allow customers to claim redeliveries of items which are marked as "copy" on the website.'''''</span>
By default, these notifications are on.  


::<span style="color:#F00;">'''''NOTE: "Search" on a multi-product vendor does NOT mean inworld search. Vendor search allows you to find a product IN the set of products in the vendor with a specific keyword. If you want products to show on inworld search, you will need to set up your own keyword prims.'''''</span>
If you are migrating a busy store to CasperVend, and you don't want these notifications cluttering your local chat buffer, simply to to your overview tab, and scroll down to the options box on the bottom of the middle column, and turn them off.


&nbsp;
'''NOTE:''' Disabling sales notifications '''does not''' stop failed transaction notices - this is intentional, so that you are notified of issues.


::<span style="color:#F00;">'''''NOTE: "Search" on a multi-product vendor does NOT mean inworld search. Vendor search allows you to find a product IN the set of products in the vendor with a specific keyword. If you want products to show on inworld search, you will need to set up your own keyword prims.'''''</span>
== '''<span style="color:#00528c">Rez Your Vendors</span>''' ==
: 1) Choose a vendor style from the CasperVend folder and rez it out.  


&nbsp;
: 2) Grant '''[[Debit_Permissions | debit permissions]]''' - the vendor will not function without them.


:'''<big>11) Repeat steps 9 & 10 for each product you want to configure.</big>'''
: 3) At this point, you will see one or more products magically appear on your inworld vendor.
:: ''You will see your vendor(s) inworld updating with all the products as you enter them!''


&nbsp;
: 4) The default action on click for ALL vendors is "touch" - you may, if you wish, set it to "Pay" instead.  (Right-Click > Edit > "General" tab > Default Action pulldown = Pay Object).


Congratulations, you're now set up with your new CasperVend system!
: 5) Do '''not''' use "buy", because all "buy" will do is sell your customers the MAPPING notecard and the vendor script.


== '''<span style="color:#00528c">Frequently Used Options</span>''' ==
=== "Take a Copy" grid-based quirk ===
----
There's a quirk with using "Take Copy" with rental units and vendors, that you should be aware of.


You can also...
Because the server is unaware of this copy being made, the copy that ends up in your inventory is LINKED to the one that is still rezzed, and is NOT a proper copy.
:* ...set up [[CasperVend_2/Affiliates | affiliate vendors]]
 
:* ...set your vendors for a [[CasperVend_2/Customers_Page | store-wide sale]]
If you then modify the one that's still rezzed, the copy that you took *will change too*.
:* ...link your [[CasperVend_2/Marketplace_Link | Marketplace via ANS]] (Marketplace store owner name MUST match CasperVend system owner name)
 
:* ...keep [[CasperVend_2/DropBoxes#Backup_DropBoxes | backup dropboxes]] in case of sim/region failure
To avoid this, TAKE into inventory and then REZ the copy. This will create a proper copy with its own unique UUID.
:* ...import your sales data from [[CasperVend_2/CSV_Import | other supported vending systems]]
 
:* ...sell textures, if you have the TextureVend pack. See the [[CasperVend_2/TextureVend | TextureVend page]] for details.
=== How do I put my textures on the vendor? ===
:* ...rez demos, if you have the HoloVend pack. See the [[CasperVend_2/Holovendors | holovendors page]] for details.
----
: If you are using the "Headless" vendor, just apply the texture right to the vendor inworld.
 
: If you are using any other type of panel vendor, add the texture UUID to the product listing on the website.
 
=== What size should I make the texture?  ===
----
 
: We '''*RECOMMEND*''' no larger than 512 x 512 for viewing on the vendor. This allows the texture to load quickly for most people.
 
: While you can upload larger filesize textures, keep in mind that if your texture won't load for the customer (not everyone has high broadband and state-of-the-art computers), customers are NOT likely to buy. It's to your advantage to keep the filesize small, to make them load quickly.
 
=== But I just want to use my existing vendor prims! ===
----
No scripting is required to use your own vendor objects!
 
If you are using something equivalent to the behavior of a "buy box", and just want to convert that to CasperVend, use the "Headless Vendor" box, and see '''[https://wiki.casperdns.com/images/1/1a/Flowchart_for_using_existing_vendor_objects.png this flowchart]''' for the process overview.
 
== '''<span style="color:#00528c">Adding New Products</span>''' ==
: Use the same steps above that you used to create your initial products and listings.  
 
== '''<span style="color:#00528c">Show Specific Product(s) On Specific Vendor(s)</span>''' ==
 
If you want to have only certain products showing on a specific multi-panel vendor, you will need to set up - and use - '''[[CasperVend_2/Profiles_and_groups | profiles]]'''.
 
== '''<span style="color:#00528c">Vendor Configuration - Profiles (Multi-Product)</span>''' ==
 
Once you have your profiles set up, it's time to attach the appropriate profile to the appropriate vendor.
 
: 1) To get to the vendor's configuration page, click the main (usually the largest, or the most centered) panel on the vendor, and select "admin" from the popup menu.
 
: 2) That will take you to the specific configuration page for that vendor.
 
: 3) Use the "Change" link on the profile line, and use the pulldown to select the profile for that vendor.
 
: 4) Select the profile, and click "save".
 
: 5) Page will process, and the appropriate profile will appear on the multi-panel vendor.
 
== '''<span style="color:#00528c">Vendor Configuration - Single Product</span>''' ==
 
: 1) To get to the vendor's configuration page, click the main (usually the largest, or the most centered) panel on the vendor, and select "admin" from the popup menu.
 
: 2) That will take you to the specific configuration page for that vendor.
 
: 3) Down at the bottom of the configuration options, there's a pulldown bar right above the column of product pictures.
 
: 4) Click that, and select the single product you want on that vendor.
 
: 5) Page will process, and the selected product will appear on the vendor inworld.
 
=== Single Item Vendor Types ===
----
All vendors - single or multi product - will rez out and '''by default''' will pull in what is called the "default" profile. However, the vendors in this list do not have arrows, and will need to be specifically told which single product you want to be shown on that vendor:
 
:* Touch vendor
:* Two-faced
:* Headless
:* Static
 
== '''<span style="color:#00528c">How do I....?</span>''' ==
:* ...set up '''[[CasperVend_2/Affiliates | affiliate vendors]]'''
:* ...set your vendors for a '''[[CasperVend_2/Customers_Page | grid-wide sale]]'''
:* ...link your '''[[CasperVend_2/Marketplace_Link | Marketplace via ANS]]''' (Marketplace store owner name MUST match CasperVend system owner name)
:* ...keep '''[[CasperVend_2/DropBoxes#When_Possible.2C_Have_Duplicate_DropBox.28es.29 | backup dropboxes]]''' in case of sim/region failure
:* ...import your sales data from '''[[CasperVend_2/CSV_Import | other supported vending systems and prior Marketplace sales]]'''
:* ...sell textures, if you have the TextureVend pack. See the '''[[CasperVend_2/TextureVend | TextureVend page]]''' for details.
:* ...rez demos, if you have the HoloVend pack. See the '''[[CasperVend_2/Holovendors | holovendors page]]''' for details.
    
    
&nbsp;
When you are ready to take full advantage of the many additional options in CasperVend, see the '''[[CasperVend_2/Setup | complete user manual]]'''.
 
If you need help with your CasperVend system, please see '''[[CasperVend_2/Getting Help|Getting Help]]''' for information on how to get in touch with us.


When you are ready to take advantage of the many additional options in CasperVend, see the [[CasperVend_2/Setup | complete user manual]].
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==


If you need help with your CasperVend system, please see [[CasperVend_2/Getting Help|Getting Help]] for information on how to get in touch with us.
: '''Q. "Currently logged in user has no access to configure this vendor" but they're MY vendors!
:: '''A1.''' This is because the vendor used to have a different type of script that the one that is inside the vendor now.
:: '''A2.''' The fix is:
:::* (1) Remove contents of description field, and hit return.
:::* (2) Shift-drag a new copy.
:::* (3) Grant perms on the new copy (the one left behind when dragging.)
:::* (4) Delete the old copy (the one you dragged.)
:::* (5) Use the NEW copy.  


Thanks for using CasperVend!
: '''Q. I'm setting up my vendors, but they're not booting up and I don't see the debit perm windows!'''
:: '''A1.''' Vendors don't finish the boot process because they're waiting for you to grant debit permissions. If you are using a v3 viewer, they can accumulate behind a tiny "chicklet toast" in the corner of your screen. Check the upper right and the lower right to see if they're hanging out there waiting for you to answer.
:: '''A2.''' All viewer3-style viewers actually '''store''' your popup notifications, unless you dismiss them. Over time, undismissed notifications build up - if you have too many, you may not be able to log in, '''OR''' you may not actually '''SEE''' any new notifications '''at all'''. You can see details of the problem AND the fix over on the '''[http://wiki.phoenixviewer.com/fs_install_crash Firestorm wiki]'''.

Latest revision as of 14:28, 11 September 2022

Dies in deutsch!

Feature List

Want to see the capabilities first? Click here.

Create Your Products

1) Create your products for sale. If your products are items to be rezzed (like furniture or buildings), remember to set the next-owner permissions while they are rezzed inworld.
2) Create the pictures to be used for your vendors and upload them to SL.
(The vendors will call the image by the UUID, and there is no UUID if the image hasn't been uploaded to SL.)
3) Create your shipping package. You cannot use folders with CasperVend - the dropbox is only capable of sending packaged products.
(box, bag, crate, whatever you want to be seen when your customers unpack everything.)
4) If your items need to be rezzed anyway, simply right-click > edit > general tab > set default action to "open" on click.
5) If you want your shipping package to unpack on rez (or on wearing) there are third party scripts available on Marketplace or Primbay. Remember to TEST FIRST.

Why Do I Have to Upload My Images?


Q. Why do I have to upload my images? Marketplace allows free uploads, why can't CasperVend do that?
A. The vendor scripts call the images via the image's UUID. You can only GET a UUID for an image, if the image has been uploaded to SL. Remember, Marketplace is run by Linden Lab, and it has its own "inventory servers" from which the images gets shown. That's why Marketplace images don't need to be an SL upload.

Package Your Products

1) Each product (with its respective parts) goes in one shipping package.
1a) This shipping package can be a bag, a crate, whatever. It CANNOT be a folder, because the DropBox cannot deliver a folder.
2) Add any relevant notecards, landmarks, product pictures, etc. that you want the customers to have for that product into that shipping package at this time.
3) Make sure each product package has its own unique name.
4) Pick up your newly named shipping package(s).

Unpack CasperVend Crate & Fill Your DropBox

1) Unpack your CasperVend shipping crate.
2) Rez a copy of the CasperTech DropBox (the box, not the sphere).
3) Drag your product package(s) from your inventory into the "contents" tab of the DropBox.
4) Add your store landmark - and give it a generic name, such as "((your store name)) - Main Location".
5) All packages, notecards, landmarks, and any textures must ALL have unique names. This is to prevent the system from getting confused and thinking the wrong item is the product package.
5) Dropboxes MUST remain rezzed inworld to deliver items!

Set Up Product Listings

1) Once everything is in, and the dropbox has finished sending data up to the website, click the DropBox and select "Admin" from the popup menu.
2) Let it take you to the CasperVend website where you can create your account and log in.
3) Click "Products" on the left column.
4) If you have no products set up already, the page will be empty. This is normal until you begin setting up products. (The "Products" page only shows completed listings.)
5) Click the green "List New Product" button
6) You will now be presented with the product setup screen for your individual product.
7) See the product options page for details on how to set up products.
8) To save space in your dropbox, for each product's vendor texture, simply right-click on the texture in your inworld inventory, select "copy UUID", and paste that in the UUID box within the product listing page.
9) Remember to click "save" at the bottom when you are done filling in product information.
10) Repeat for each product you want to set up at this time.

Sales Notifications

There is a link on the Overview tab to turn sales notifications on or off.

By default, these notifications are on.

If you are migrating a busy store to CasperVend, and you don't want these notifications cluttering your local chat buffer, simply to to your overview tab, and scroll down to the options box on the bottom of the middle column, and turn them off.

NOTE: Disabling sales notifications does not stop failed transaction notices - this is intentional, so that you are notified of issues.

Rez Your Vendors

1) Choose a vendor style from the CasperVend folder and rez it out.
2) Grant debit permissions - the vendor will not function without them.
3) At this point, you will see one or more products magically appear on your inworld vendor.
4) The default action on click for ALL vendors is "touch" - you may, if you wish, set it to "Pay" instead. (Right-Click > Edit > "General" tab > Default Action pulldown = Pay Object).
5) Do not use "buy", because all "buy" will do is sell your customers the MAPPING notecard and the vendor script.

"Take a Copy" grid-based quirk


There's a quirk with using "Take Copy" with rental units and vendors, that you should be aware of.

Because the server is unaware of this copy being made, the copy that ends up in your inventory is LINKED to the one that is still rezzed, and is NOT a proper copy.

If you then modify the one that's still rezzed, the copy that you took *will change too*.

To avoid this, TAKE into inventory and then REZ the copy. This will create a proper copy with its own unique UUID.

How do I put my textures on the vendor?


If you are using the "Headless" vendor, just apply the texture right to the vendor inworld.
If you are using any other type of panel vendor, add the texture UUID to the product listing on the website.

What size should I make the texture?


We *RECOMMEND* no larger than 512 x 512 for viewing on the vendor. This allows the texture to load quickly for most people.
While you can upload larger filesize textures, keep in mind that if your texture won't load for the customer (not everyone has high broadband and state-of-the-art computers), customers are NOT likely to buy. It's to your advantage to keep the filesize small, to make them load quickly.

But I just want to use my existing vendor prims!


No scripting is required to use your own vendor objects!

If you are using something equivalent to the behavior of a "buy box", and just want to convert that to CasperVend, use the "Headless Vendor" box, and see this flowchart for the process overview.

Adding New Products

Use the same steps above that you used to create your initial products and listings.

Show Specific Product(s) On Specific Vendor(s)

If you want to have only certain products showing on a specific multi-panel vendor, you will need to set up - and use - profiles.

Vendor Configuration - Profiles (Multi-Product)

Once you have your profiles set up, it's time to attach the appropriate profile to the appropriate vendor.

1) To get to the vendor's configuration page, click the main (usually the largest, or the most centered) panel on the vendor, and select "admin" from the popup menu.
2) That will take you to the specific configuration page for that vendor.
3) Use the "Change" link on the profile line, and use the pulldown to select the profile for that vendor.
4) Select the profile, and click "save".
5) Page will process, and the appropriate profile will appear on the multi-panel vendor.

Vendor Configuration - Single Product

1) To get to the vendor's configuration page, click the main (usually the largest, or the most centered) panel on the vendor, and select "admin" from the popup menu.
2) That will take you to the specific configuration page for that vendor.
3) Down at the bottom of the configuration options, there's a pulldown bar right above the column of product pictures.
4) Click that, and select the single product you want on that vendor.
5) Page will process, and the selected product will appear on the vendor inworld.

Single Item Vendor Types


All vendors - single or multi product - will rez out and by default will pull in what is called the "default" profile. However, the vendors in this list do not have arrows, and will need to be specifically told which single product you want to be shown on that vendor:

  • Touch vendor
  • Two-faced
  • Headless
  • Static

How do I....?

When you are ready to take full advantage of the many additional options in CasperVend, see the complete user manual.

If you need help with your CasperVend system, please see Getting Help for information on how to get in touch with us.

FAQ / Troubleshooting

Q. "Currently logged in user has no access to configure this vendor" but they're MY vendors!
A1. This is because the vendor used to have a different type of script that the one that is inside the vendor now.
A2. The fix is:
  • (1) Remove contents of description field, and hit return.
  • (2) Shift-drag a new copy.
  • (3) Grant perms on the new copy (the one left behind when dragging.)
  • (4) Delete the old copy (the one you dragged.)
  • (5) Use the NEW copy.
Q. I'm setting up my vendors, but they're not booting up and I don't see the debit perm windows!
A1. Vendors don't finish the boot process because they're waiting for you to grant debit permissions. If you are using a v3 viewer, they can accumulate behind a tiny "chicklet toast" in the corner of your screen. Check the upper right and the lower right to see if they're hanging out there waiting for you to answer.
A2. All viewer3-style viewers actually store your popup notifications, unless you dismiss them. Over time, undismissed notifications build up - if you have too many, you may not be able to log in, OR you may not actually SEE any new notifications at all. You can see details of the problem AND the fix over on the Firestorm wiki.