Adult Script Pro Community Forums

Hi,

First thing for the RC1 development is the subcategories (was not initially planned, however more and more clients want this feature). There are 2 methods to implement this:

1. One mysql table, you can get everything in one query but some code in php is required to create a good hierarchical tree. This supports only 1 sublevel (basically a category
can have one or more subcategories (a subcategory cannot have sub-sub-categories)). This is already implemented and its quite fast, however if i would decide to make it work
with more sublevels it would be slow. Do you think that more than 1 sublevel is required?

2. One mysql table with a range for the categories, this can have infinite number of sub-sub-levels. It is not so easy to implement, getting data from mysql is easy and fast, adding/updating
data is slow.

Hi,

Basically Adult Script Pro allows you to add your own pages (static) to your adult tube site directly from the administration panel. You will need to login to Admin and go
to Admin -> Content -> Add. A static page has the following properties:

* Name - the name/identifier of the site, will be used in the url and it should contain only alphanumeric, dashes and underscore characters
* Status - set the status for this static page (published/suspended)
* Meta Title - the tmeta title displayed for this static page (useful for SEO)
* Meta Description - the meta description for this static page (useful for SEO)
* Meta Keywords - the meta keywords for this static page (useful for SEO)
* Title - the title of this static page (will appear in the <title></title> tags and as a header in the template box)
* Content - the html content of this static page

After you add your static page the frontend url for your page will be http://www.yourdomain.com/static/name-o … atic-page/ (see above for the name).

Another method to add your own pages is to create a new module. This method involves some PHP programming and adding a new mysql row. Properties of the module
mysql table (you will need to add a new row for the module to work, this will be available in the administration panel directly in future versions):

* name - the identifier for this module (will be used to identify the access for this module and in the url of your module, eg: http://www.domain.com/module-name-here/)
* description - a description to help managing the modules in Admin -> Extend -> Module Manager
* type - should always be set to extension (by default new modules are extensions)
* version - version of your module (1.0.1 for example)
* provider - provider (the person/company that created this module, you will need to register your name/company with us in the future, for now, you can enter anything you want)
* access - not currently used (should be set to all)
* config - the default configuration for your module, should be a serialized array (only useful if you plan to have options for your module)
* config_cache - the current configuration for your module, should be a serialized array (only useful if you plan to have options for your module, config contains the default settings, while config_cache
will contain the current values of the settings)
* add_date - the add date in yyyy-mm-dd hh:mm:ss format when this module was installed
* update_date - the update date in yyyy-mm-dd hh:mm:ss format when this module was upgraded (will be used for the upgrade system in admin in the future)
* status - set this module to be enabled/disabled (set this to disabled, as you will need to enable your module from the Admin, to also update the module cache)

A mysql query example (you need to add this from a mysql console or phpmyadmin):

INSERT INTO `module` SET name = 'helloworld', description = 'Hello World Module', type = 'extension', version = '1.0.0', provider = 'adultscriptpro', access = 'all', config = '', config_cache='',
add_date = '2011-01-01 08:18:21', update_date = '0000-00-00 00:00:00', status = '0'

The module files will be organized as following:

modules/module-name/
modules/module-name/components/
modules/module-name/components/component-name.php
modules/module-name/helpers/
modules/module-name/module-name.php
templates/your-template/module-name.tpl.php
templates/your-template/module-name_component-name.tpl.php

Components and helpers are not required by default, but useful if you want to extend your module in the future.

A simple example for a module that only displays one page would contain the following files:
modules/helloworld/helloworld.php:

<?php
defined('_VALID') or die('Restricted Access!');
class VModule_helloworld
{
    public function __construct()
    {
    }

    public function render()
    {
        // code here (if you want your module to do anything else except displaying the template)     

        $tpl = VF::factory('template');
        $tpl->menu        = 'helloword'; // useful if you want the menu item for this module to be highlighted
        $tpl->title           = 'Title for this module will go here'; // useful if you want your page to have a different title
        $tpl->meta_desc = 'Meta Description for this module will go here'; // useful if you want your page to have a different meta description
        $tpl->meta_keys = 'Meta Keywords for this module will go here'; // useful if you want your page to have different meta keywords
        $tpl->css            = array('url' => '/absolute/path/to/a/css/file.css'); // only useful if you want to load a separate css file for this module
        $tpl->js               = array('url' => '/absolute/path/to/a/js/file.js'); // only useful if you want to load a separate js file for this module
        $tpl->load(array('header', 'helloworld', 'footer'));
        $tpl->display();
    }
}
?>

templates/your-template/helloworld.tpl.php:

<?php defined('_VALID') or die('Restricted Access!'); ?>
<div id="page">
// here you can add anything you want (html/php)
</div>

After all the above is done, you will need to go and enable your module from Admin -> Extend -> Module Manager.

The above is only a basic example, a module can be extended with components and helpers. I will add code and description for components and helpers to this
howto in the future. As a good practice, its recommended that you study the modules in the modules/ folder.

Please let us know if you have any questions/concerns (idea/critics are also welcome).

Hi,

Here's a small howto on installing Sphinx Search (http://sphinxsearch.com/) and configuring it to work with Adult Script Pro. By using sphinx
you will be able to allow users to search for video on your adult tube site by title, description and tags. The search results will be automatically
ordered by relevance (its almost the same as using mysql MATCH_AGAINST, but faster and it can support even 1.000.000 videos).

You will need ssh root access. The installation itself is quite easy, depending on your distribution:

Ubuntu (tested on Ubuntu 10.10):

sudo apt-get update
sudo apt-get install sphinxsearch

CentOs (tested on 5.4):

yum install sphinx

Configuring sphinx si also straight forward, all you need to do is edit the sphinx configuration file and add:

source videos
{
        type        = mysql
    sql_host    = localhost
    sql_user    = mysql-username
    sql_pass    = mysql-password
    sql_db      = mysql-database
    sql_sock    = /var/lib/mysqld/mysqld.sock (this depends on your server)
    sql_port    = 3306

    sql_query_pre       = SET NAMES utf8
    sql_query           = \
        SELECT v.video_id, v.title, v.description, v.mobile, v.add_time, \
         v.rating, v.total_views, v.duration, v.video_id AS video, \ #added in RC4
         GROUP_CONCAT(DISTINCT t.name SEPARATOR ' ') AS tags \
        FROM video AS v \
        LEFT JOIN video_tags AS t ON (t.video_id = v.video_id) \
        WHERE v.status = 1 \
        GROUP BY v.video_id

        sql_attr_uint           = video #added in RC4
        sql_attr_uint           = mobile
        sql_attr_uint           = total_views
        sql_attr_float          = duration
        sql_attr_float          = rating
        sql_attr_timestamp  = add_time
        sql_attr_multi          = uint categories FROM query; SELECT video_id, cat_id FROM video_category
        sql_query_info          = SELECT video_id, add_date FROM video WHERE video_id=$id
}

index videos
{
    source          = videos
    path            = /var/lib/sphinxsearch/data/videos (this depends on your distribution)
        charset_type    = utf-8
        min_prefix_len  = 3
        enable_star     = 1
}

searchd
{
        port            = 3312
        log                     = /var/log/sphinxsearch/searchd.log (this depends on your distribution)
        query_log       = /var/log/sphinxsearch/query.log (this depends on your distribution)
        pid_file        = /var/log/sphinxsearch/searchd.pid (this depends on your distribution)
}

The sphinx data and log folders might depend on your distribution.

After this you need to create the initial index with the following command:

indexer --all --config /path/to/your/sphinx/configuration/file.conf

You will also need to create a cron file and place it into the /etc/cron.hourly (or add it to cron from cpanel or console). The script
should be named sphinx and chmoded to 755, with the following contents:

#!/bin/bash
/usr/bin/indexer --all --rotate --config /path/to/your/sphinx/configuration/file.conf

Thats it :-)

If you dont have the time do the installation yourself, or you dont like the linux console, just drop us a email and we can do the installation
for 49$.

Hi,

Here's a small howto about menus in Adult Script Pro. Basically Adult Script Pro offers support for adding and editing
the menus directly from the Administration Panel.

How are menus organized:
* Name (identifier) - is the SLUG/identifier for the menu (can contain only a-z and dashes/underscores). It is used to identify the menu that is loaded by the script.
* Title - used for Administration Panel identification purposes only
* Status - active/suspended (active means menu will appear on the site, suspended means the menu will not appear on the site)

Each menu can have one or more Menu Links (which are actually the buttons/links in the menu). Menu Links have the following properties:
* Menu - the current link will be displayed in this menu
* Name - the actual Name/Text of the link (will be displayed in the menu)
* Title - will be displayed on mouse over
* Link/URL - the link/url for this menu entry (can be a absolute url,: /photo/recent/ or a full url: http://www.adultscriptpro.com)
* Type - can be Internal, which means the link is a internal link (pointing to a url on your domain, and you can use a absolute url in this case) or External, which can be any full URL.
* Target - can be Same Window/Tab or New Window/Tab
* Translation - a identifier to use for the translation if the Language is non-english (if the language is English, the Name of the menu entry will be used)
* Current - a identifier for the current page, if the current page identifier (every page in the script has one) is the same as the menu entry current identifier this link will be highlighted

A small FAQ about the menus:

Q: How do i add a menu entry to the Main Menu?
A: The current template does not have enough space for new menu entries, however if you disabe a few items (depending on what you want, the forum/premium links
can be disabled), you can add new menu entries from Admin -> Menu -> Add Menu Link

Q: How do i disable a menu entry/link?
A: From Admin -> Menu -> Manage -> Menu Links (icon) -> Edit -> Suspend

Q: How do i disable a menu entry/link and completly disable the support for the module related to the link?
A: Disable the menu link from Admin -> Menu -> Manage -> Menu Links (icon) -> Suspend (icon) and from Admin -> Extend -> Menu Manager -> Suspend (icon)
you can disable the related module.

Please let us know if you have any questions/sugestions (critics are also welcome).