########################## STAGE 6 #########################
This File explains how you can setup and configure your stage6
plugin to work in elisa.

##
# Setup of elisa
## 

- stop elisa
- open the configuration file in your favorite editor. In most
  cases, the configuration file is ~/.elisa/elisa.conf
- search for the line media_providers. It is at the general-section
  at the top.
- add to the list behind = and between the brakets this:
    'stage6:stage_media'

- now your line should like a bit like this:
    media_providers = ['stage6:stage_media', 'base:local_media']


That's it. You can now start elisa.

##
# Troubleshooting
##
Check for this:
 - is BeautifulSoup installed?
 - stage6:stage_media is spelled correctly
 - there are commas between the entries of the list
 - the list is between the two brackets []
 - the list is in ONE line (no breaks in the list!)

If you still have trouble, don't bother to ask on IRC: irc.freenode.net #elisa


##
# Configure the plugin
##

After starting and again stopping elisa, you have a new section
in your configuration file: [stage6:stage_media]

There you can configure the plugin. Currently there this configuration
options:

 - pages : Stage6 (and the plugin also) provides a lot of pages for every
           entry. This feature is still experimentel and not official
           supported, even it should work very well in most cases.

 - email
     and
 - password : If you are registred at Stage6, you can put the registered
              email and the password here. Then the plugin is able to
              register, which makes the access to the page a bit faster
              and you are able to access your WishList.
              The plugin then, as well, knowns your settings, what means, that
              it is displaying adult-movies also, if your settings are set to
              show them.

 - certain_uris: Beside the much uris, the plugin provides on its own (did you
                 try the email/password and the Wishlist stuff already ;) ),
                 you can set more uris here. This is as well a list, so don't
                 forgett the brakets ;). If you want to know, 'How to make a
                 Stage6-Uri', you might take a look at "How to make a
                 Stage6-Uri" ;).
                 These Uris then appear in the subfolder "Certain Uris" in
                 Stage6. Because the plugin is not accessing them, it is not
                 able to make a thumbnail for this uris and currently you are
                 also not able to configure the label which is displayed...


##
# How to make a Stage6-Uri
##
In some cases, you don't to use the Wishlist-Function of this plugin, or for
e.g. want a search displayed in the plugin as well. For this you could use the
certain_uris (see above). But the big question is: "How can I make an Uri in
the Browser to be usable in elisa?"

Okay. Let's do it on a small example. The thing you need, is the path on the
server. For e.g. you surfed to a page on stage6, like this one:
    http://stage6.divx.com/HD-DVD

Attention: The Stage6-Plugin is parsing the HTML-Page, what means, that it is
displaying only the movies, you can the one the page on your own. So, for this
example, you might want to click on 'View all', which brings you on that page:
    http://stage6.divx.com/HD-DVD/videos/

This site contains the videos of the Group HD-DVD. So, as said before, we need
the path only. For this uri, that would be:
    /HD-DVD/videos/

We need the whole path. But you have to cut off all that is before (and
including) the .com. So another example:
That http://stage6.divx.com/videos/search:dvd
would become /videos/search:dvd

Okay. That's okay so far. But that is not enough for the plugin. We have to
add a scheme before this: stage6://. So the uris would now look like this:

 * stage6:///HD-DVD/videos
 * stage6:///videos/search:dvd

That's it. You can add this uris in single quotes to the list of certain_uris
and they would appear in the Certain-Uris-Folder. If not, take a look at
##URI-Troubleshooting

But some want to have more...

# I WANT MORE

You can also, instead of getting the videos directly, say the plugin to use
the tags. Then it is downloading the tags of this page and displays them as
folders, you can access. For this you only have to put at tag to a certain
place of your uri: directly after stage:/// and before the path. So this uri
    stage6:///HD-DVD/videos/ becomes stage6:///tags/HD-DVD/videos


# Richness

This way of accessing is a very rich possibility of the uri, because it works
with every page on which you can see video-previews or tags. That includes also
Group-Videos or searches in Group-Videos or Users-Videos only...



### URI-Troubleshooting
Be sure that your Uri is at least:
   'stage6' + ':' + '//' + '/path/with/slash/at/thebeginning'
That means: the Uri has to have at least 3 slashes (///) behind the stage6!

There are only 3 Videos shown?
Are you sure, that you used the right uri? On the overview page of a Group are
only 3 Videos shown. You might want to use the uri, which you get after you
clicked on "View All".




At this point, there only one little thing left to say:

Have a lot of fun
    Benjamin Kampmann <benjamin@fluendo.com>


#
# Please mail me, if you have something to add or correct!
#
#



