

##############################################################################
###                                                                        ###
###                                                                        ###
###              JoomlaStats SDK (Software Development Kit)                ###
###                                                                        ###
###                                                                        ###
##############################################################################






What JoomlaStats SDK is?
============================
    JoomlaStats SDK is set of tutorials, manuals, examples and documentation
that help You design Your own exstension.




SDK version is: r337
============================
    This is SDK for v2.3.x of main component
(com_joomlastats_v2.3.x.zip - to j1.0.15 and j1.5.x Legacy)




What is gain of using JoomlaStats?
=====================================
    Using JoomlaStats as engine/statistics platform allow You save huge amout
of time during developing Your extension. Though PHP 'interface' JoomlaStats 
(share) basic and sufisticated options/data/features. You do not have to worry 
about dealing with database or/and method of possesing data about visitors.




Can we use JoomlaStats for pages outside 'Joomla CMS'?
==========================================================
    Yes. For today JoomlaStats component/engine require 'Joomla CMS' for
working, but It allows to count pages outside 'Joomla CMS' and present data 
on such pages.
    Now we are working on JavaScript that will gather information about
visitors on any types of pages (plain HTML, PHP, ASP etc.).
    Currently statistics could be only presented on PHP pages in 'Joomla CMS'
envinronment or outside it.





How it works?
==========================
    Below is presented basic structure of JoomlaStats.
    
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

                                          +--^^--+
    J                                     |  JS  |
    O                                     |  DB  |
    O                                     +--__--+
    M                                      /
    L                                     /
    A                                    /
                 +------------------------+
    C            |      JoomlaStats       |
    M            | engine/com_JoomlaStats |
    S            +------------------------+
                             |
                             |
 - - - - - - - - - - - - - - | - - - - - - - - - - - - - -
                             |
                             |
    P              +--------------------+
    H              |    JoomlaStats     |
    P              |     interface      |
                   +--------------------+
    e                  /           \
    n                 /             \
    v                /               \
    .               /                 \
                   /                   \
        +--------------+            +--------------+
        |  3-rd party  |            |  3-rd party  |
        |  extenssion  |            |  extenssion  |
        +--------------+            +--------------+
                              
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - -


 

Words/shortcuts dictionsry
==========================
JS     - JoomlaStats
3-rd   - 3-rd party extenssion. JoomlaStats non-official extension - Your
         extension
DB     - database
engine - JoomlaStats engine is provided as pagckage to 'Joomla CMS' system
         eg. 'com_joomlastats_v2.3.0.zip'



