CasperVend 2/Quick Start: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
mNo edit summary
 
(117 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. You can use just one dropbox if you like, or more if you prefer.  We recommend that you have a second copy of your dropbox(es) on another sim, to provide a backup for delivery.'''
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) Place all of your products into the contents of your dropbox(es).</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.) ''


:: ''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.''
: 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: Your DropBox MUST stay rezzed, or your deliveries will fail.'''''</span>
: 4) If your items need to be rezzed anyway, simply right-click > edit > general tab > set default action to "open" on click.  


:: <span style="color:#00528c;">'''''REMEMBER: Make sure your product packaging has a DIFFERENT name than your picture, landmark, or associated notecard. Delivery works by NAME, not UUID - you have different things with identical names, it may deliver ANY of them, which means your customer may get a picture or a notecard or a landmark instead of the packaged product!'''''</span>
: 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 a texture for each of your products into the DropBox(es).</big>'''  
: '''Q. Why do I have to upload my images? Marketplace allows free uploads, why can't CasperVend do that?'''


:: ''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. ''
: '''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: 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">Package Your Products</span>''' ==
: 1) Each product (with its respective parts) goes in '''one''' shipping package.


&nbsp;
: 1a) This shipping package can be a bag, a crate, whatever. It '''CANNOT''' be a folder, because the DropBox cannot deliver a folder.


:'''<big>4) Rez a vendor (Not the CasperVend Touch or Headless, to begin with) and grant debit permissions.</big>'''
: 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.  


:: ''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.''
: 3) Make sure each product package has its own unique name.


&nbsp;
: 4) Pick up your newly named shipping package(s).


:'''<big>5) When the vendor has loaded, touch the "CasperVend" logo in the bottom left hand corner of the vendor.</big>'''  
== '''<span style="color:#00528c">Unpack CasperVend Crate & Fill Your DropBox</span>''' ==


:: ''This will then ask to open a URL to our website - go ahead and open it up.''
: 1) Unpack your CasperVend shipping crate.  


&nbsp;
: 2) Rez a copy of the CasperTech DropBox (the box, not the sphere).


:'''<big>6) If you are new to CasperVend, please enter a secure password, otherwise, just log in.</big>'''
: 3) Drag your product package(s) from your inventory into the "contents" tab of the DropBox.


:: '''''<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>'''''
: 4) Add your store landmark - and give it a generic name, such as '''"((your store name)) - Main Location"'''.


&nbsp;
: 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.


:'''<big>7) Once you are logged in, click the large "Products" button on the left hand side, and then click "[Create New]".</big>'''
: '''5) Dropboxes MUST remain rezzed inworld to deliver items!'''
:: ''This is the page where you will be setting up all of your product information.''


&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>8) Please fill out information on one of your products.</big>'''  
: 2) Let it take you to the CasperVend website where you can '''[[Passwords_CasperVend | create your account]]''' and log in.


:: ''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.''
: 3) Click "Products" on the left column.


::<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>
: 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.)


&nbsp;
: 5) Click the green [[File:Listnew.png||||"List New Product"]] button


:'''<big>9) Repeat steps 7 & 8 for each product you want to configure.</big>'''
: 6) You will now be presented with the product setup screen for your individual product.
:: ''You will see your vendor inworld updating with all the products as you enter them!''


&nbsp;
: 7)  See the '''[[CasperVend_2/Product_Options | product options]]''' page for details on how to set up products.


Congratulations, you're now set up with your new CasperVend system!
: 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.


== '''<span style="color:#00528c">Frequently Used Options</span>''' ==
: 9) Remember to click "save" at the bottom when you are done filling in product information.


You can also...
: 10) Repeat for each product you want to set up at this time.
:* ...set up [[CasperVend_2/Affiliates | affiliate vendors]]
 
:* ...set your vendors for a [[CasperVend_2/Customers_Page | store-wide sale]]
== '''<span style="color:#00528c">Sales Notifications</span>''' ==
:* ...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
There is a link on the Overview tab to turn sales notifications on or off.
:* ...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.
By default, these notifications are on.
:* ...rez demos, if you have the HoloVend pack. See the [[CasperVend_2/Holovendors | holovendors page]] for details.
 
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.
 
== '''<span style="color:#00528c">Rez Your Vendors</span>''' ==
: 1) Choose a vendor style from the CasperVend folder and rez it out.
 
: 2) Grant '''[[Debit_Permissions | 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 '''[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.