Skip to main content

Requirements

You need Joomla 3.x, MySQL 5.7.8 and php 5.3.1 +, php 7+ recommended.

Here are Joomla's requirements.

You need a language pack for MyMuse in your language. If we do not have one contact us and we will start a translation.

  • Hits: 5565

What Do I Do First?

1) Edit the Store

Go to Components->MyMuse Simple->Store

If you enter a description it can be pointed to with a menu of type MyMuse->MyMuse Store Layout
That view can also show any products labeled as featured, in a blog type layout.

You will want to edit the Contact Info.
You will want to upload your own logo and point to it in the Small Logo field.

Check and edit any Store Parameters you want to change.

Decide what kind of registration you want: Joomla, Full, No Registration, Full and Guest or perhaps yours is handled by another Component.

Optional: Add sample data. If you did not do this at install time, just go to the main MyMuse Simple menu, also called 'Quick Start'. There will be a link to 'Install Sample data'.

Related Help Screen.

2) Edit Plugins

Go to Components->MyMuse Simple->Mymuse Plugins

  • - Choose the payment processors you want to be be live and enable them. You must also open them up and enter your personal data, for example your PayPal email for the PayPal plugin.
  • - Choose the Preview Player you want for MP3's and Videos. 
    Or write your own plugins :)

Related Help Screen.

3) Edit User Plugins

Go to Components->MyMuse Simple->User Plugins

  • - Choose the user plugins you want to be be live and enable them..
  • - For Full Registration you want to enable User - MyMuse Profile.
  • - For No Registration you want to eneable User - MyMuse No Registration Profile.

Open the plugins to see what fields you want shown and required. You can also use the standard Joomla profile or write your own. Make sure you go back to the store parameters and enter the name of the profile plugin file under "Store Options". You should also select Registration Type: Full.

If you do not want to create users, you can choose Registration Type: No Registration. Go to the Plugins->User and eneable User - MyMuse No Registration" plugin. Open this plugin and choose what fields you want to capture. They will be saved in the "Notes" field of the order.

Related Help Screen.

4) Set MyMuse Simple Options

Go to Components->MyMuse Simple Choose "Options" at the top right.

On the main MyMuse screen there is an icon for "Options" on the top right. It is similar to the Joomla Article Options with the addition of product options. There are too many options :) but we hope the defaults are a good starting place.

Related Help Screen.

5) Make Categories

Go to Components->MyMuse Simple->Categories

These can be the names of Artists or Genres or just MyMusic. I like to make a top level called MyMuse and two sub-categories called Artists and Genres.
If you are a solo artist just make one category with your name, or the name of your group.
You can assign products to an Artist and another Category.

Related Help Screen.

6) Make Products

Go to Components->MyMuse Simple->Products

Products are there to hold the description and the tracks.
Add your tracks (downloadable) after saving the product.

Related Help Screen.

7) Make Menus.

  1. One or more menus that point to your Store and products. This could be a Store, Category or Product type menu.
  2. A menu that points to the Shopping Cart.
  3. Optional: A User Menu item that points to User Profile Edit Layout, if you are using Joomla or Full Registration.
  4. Optional: A MyMuse Item menu that points to  List My Orders, if you are using Joomla or Full Registration.

Related Help Screen.

  • Hits: 4900

Where Do Files Go?

Graphics: Put category/product images wherever you like.

Previews: Previews can be uploaded through the Media Manager or by FTP.

By default the preview directory is images/mymuse/previews.
MyMuse adds to the Media Manager options so that you can upload mp3's through the media manager.
Previews will show up in dropdowns in the Add/Edit Tracks screens so it is best to upload them BEFORE creating tracks.

 

Downloads: The Main file for sale, also called the payload, can be uploaded through the Media Manager or by FTP.

By default the download directory is images/mymuse/downloads/mp3.
MyMuse adds to the Media Manager options so that you can upload mp3's through the media manager.

For security, if using apache web server, and your download files are within the web directory, confirm there is a file .htaccess at the top of the download directory

download_dir/.htaccess

The default is:
images/mymuse/downloads/mp3/.htaccess


This should stop direct downloads of files.
If it is not there, you can copy it from administrator/components/com_mymuse/assets/htaccess.txt ->
images/mymuse/downloads/mp3/.htaccess

  • Hits: 4835

Store Configuration

Go to Extensions->MyMuse Simple->Store

Here you can configure your store. You want to at least set your own Contact information.
If you use the Store view in a menu it will display the description and any products set as featured.

Description

The Store [edit] page holds information for your store.

 store store

Store
  • Title (required): the name of your store.
  • Alias (optional): Joomla! will create an alias that can be used in SEF URL's
  • Top Level Category: the category to associate with the store.
  • Status: published or not.
Description
  • This is the default description of your store. You can point to it from a menu item by choosing
    MyMuse->Store->Store Layout

 

EDIT CSS: Edit  CSS that applies to MyMuse

store edit css

 

CONTACT: will be used with all emails.


store edit contact
 
  • First Name
  • Last Name
  • Title (optional)
  • Email
  • Phone
  • Fax
  • Address 1
  • Address 2
  • City
  • State/Province/Region
  • Country: choose your country and if we know the states/provinces we will show them
  • Zip/Postal Code
  • Currency: will be sent to your payment processor as your currency
  • Small Logo: will be used on html emails


DOWNLOAD OPTIONS
store edit download options
 
  • Downloads Enable: Turn downloads on or off.

  • Download Max: Maximum number of times the customer can make the download.

  • Download Expire: How long until the download expires in seconds (43200 is 3 days).

  • Download Enable Status: The order status that is required before downloads are
    enabled 'C; is confirmed.

  • Download Directory: The FULL PATH to the download files. Depending on your hosting, you may be
    able to put this out of the web directory. /path/to/your/site/images/mymuse/downloads/mp3.

  • Use Zip for All Files: When creating an "All Files" type of track (selling all the files for one album/product), make a zip file on the fly. This saves the customer downloading each file separately.

    You must have the zip enabled in your PHP and have the memory available per process for all the files combined. memory_limit should be greater than all the files plus the regular php process. This can be quite big is selling wav files :)

  • Preview Directory: The relative path to the preview directory. 'images/mymuse/previews'.

 
STORE OPTIONS
store edit store options
 
  • Thousands Separator: For your currency.
  • Decimal Point: Some countries use commas.
  • Currency Symbol Before: Currency symbol before or after price.
  • Page if need login: When it is time to login, send them to Joomla's Registration page or Login page.
  • Type of Registration:
    • Joomla: just use Joomla's registration. Capture their name, username, email and password.
    • Full: includes Joomla registration PLUS any required or optional items from your Profile plug-in.
      The default plugin is Plug-ins->User->User - MyMuse Profile. If you activate a different plugin, enter its file name (without the .php extension).
    • Jom Social: checks if the user is logged in, if not, send them to Jom Social login page.
    • No Registration: uses a guest account to log in clients. You can still capture fields that you have set as required or optional in the
      Plug-in User->User - MyMuse No Registration Profile. These are saved in the Notes field of the order.

      Do not enable multiple profile plug-ins.
  • Checkout: Regular or Skip Confirm Page. Most payment processors recommend or insist on a Confirm Page with all the details of the order.
  • Profile Name: name of your profile plugin (just use 'mymuse' unless you know what you are doing and write your own plugin).
  • Use Product alias in URL: SEF URL's will use only the top menu alias/product alias in the router.
  • Top MyMuse Menu: This will be first in URLs before your product/category alias or cart function.
  • Show Cart Previews: Show Previews for tracks in cart
  • Show Cart Player: Show the Player in the Cart
  • Notes Required: Force the customer to enter notes.
  • Notes Title: The title above the Notes text area.
  • Notes Message: a message that appears above the notes area. Can contain html.
  • Disable CSS: Do not load the MyMuse CSS file. You have copied it into your main template.css or somewhere else.
  • Plugin email: Be notified by the Payment Plugin for every transaction.
  • CC Webmaster: copy webmaster on every email.
  • Email of webmaster
  • Name of webmaster
  • Continue shopping link: When they are looking at the cart they can choose "Checkout" or "Continue
    Shopping". This sets the link for "Continue Shopping".
  • Date Format: Change the way dates are displayed.
  • Email Message: Include an email message with emails that go out.
  • Show Original Price: Will show original price with Strike-through and the discounted price.
  • Show Category Name: Include Category/Artist name in cart with product name.
  • Show SKU: Include SKU in cart with product name.

 

PRICING OPTIONS: Select the way you set prices.
store edit pricing options
  • Pricing Model: Default is "Price by Track". Each individual track can have its own pricing.
    Option: "Price by Product". For each product set the price of files by MP3 and for All Files.

 

 

.

SALES REPORTS FOR ARTISTS: You can assign users to a group and a category, and create a menu for them to access sales reports.
store-edit-sales

 

  • Owner Group: You can create a new group for your artists or leave this as Public
  • Cut to the Artist: Percentage of sales that will be given to the artist.

 

TESTING
store edit testing

 
  • Shop Test: You do not have to pay for items. The cart session is not destroyed when making an order.
  • Debug MyMuse: Save Payment Gateway messages to /components/com_mymuse/log.txt.
  • View debug log: open a screen to view debug messages.

Toolbar

At the top left you will see the toolbar:

store-edit-toolbar

The functions are:

  • Save. Save the store and return to the list screen.

  • Save & Close. Save the store and return to the list page.

  • Close. Do not save, just return to the list screen.

  • Help. That's me :).

 

 

 

  • Hits: 4833

Registration Options

Registration Options

There are several options:

  • Joomla
    This will ask for the usual Joomla! registration fields:
    • Name
    • Username
    • Password
    • Confirm Password
    • Email Address
    • Confirm Email Address

      Note: you should not have any User->Profile plugins turned on

  • Full
    This will ask for the above Joomla! registration fields PLUS present a User Profile field set based on the active User->profile plugin.
    Use the User->MyMuse Profile plugin.
    It adds javascript to select the appropriate Region/State after a Country is chosen.
    You could create your own profile plugin. If you do you may assign that in the Components->MyMuse->Store Store Options parameter called "Profile Name". This is the name of the file without the .php ending.

    In Extensions->Plugin Manager choose Type = User.
    Open "User - MyMuse Profile".
    There are two groups of parameters
        User profile fields for registration and administrator user forms and
       
    In both groups you can set fields to be "Required", "Optional" or "Disabled"

  • JomSocial
    If you have Jomsocial installed, MyMuse will check if the shopper is logged in and, if not, redirect to the Jomsocial login page before allowing checkout.

  • No Registration
    • If you choose No Registration you should enable the User->MyMuse No Registration plugin and disable other User Profile plugins. DO NOT disable the User-> Joomla plugin or you will not be able to log in as administrator. :)
    • You can enable whatever fields you want in the User->MyMuse No Registration plugin, to capture for guest users whatever fields you need. You probably want their name and email so you may contact them.
    • People will be logged in as a guest user during their session, and, if coming from a download link in their mail (where they will be logged in as the guest user), the guest user will assume their identity, using the fields that you have chosen to enable.
    • You should not have a login module. They do not have an account so cannot log in, except by using their download links to log in as the guest user.
    • You should not have a menu item of type "List My Orders". You do not want to show all orders of the Guest User.
    • If you enable email in the plugin User->MyMuse No Registration, then users will recieve an email when they make a purchase with a download link if applicable to their purchase. If they click that link, they will be logged in as the Guest User and be able to download files.
    • RESTRICTION: since they cannot log in later, they have to download their files while their session is active.

     

Store Help Screen. Plugins Help Screen.

  • Hits: 4787