Re: [binarycloud-general] BC quick-start guide?

[alex b. <en...@tu...>]

> I recently began building what will become a very large PHP-powered site.
> I've got most of the core objects and managers built but there are two
that
> I need badly right now namely auth.(and a permission system) and db
> abstraction. I would just start using PEAR but there is no auth mechanisms

For DB Abstraction, you can use metabase, which you can import directly now
with ext.metabase.whatever the metabase core file is called, can't remember
:)

That will work fine for "direct" queries.

>  yet. I hacked on PHPLIB about 2 years ago and remember it being kind of
> painful and ungainly to work with plus it doesn't appear to have any PHP4
> clue still.

I would not recommend PHPLib at this point, the whole thing is in flux, and
yes still no php4.

> So here I am with BC. I looked at R2 and it's really not clear to me how
to
> get started with it. Is there a quick-start guide anywhere? Should I even
be

You're building pages, and modules to use in those pages. Have a look at
index.php, note that it's a definition of a series of modules, and
templates. you can find all of those files in user/mod/,
user/tmpl/html/layouts and user/tmpl/html/masters

> messing with R2? MetBase looks really cool but again Im a bit lost as to
how

The r2 page pipeline is basically done, I'm going to add module caching
shortly but those are advances features you can use without modifying any of
your module code.

What's "missing":
    -You can't 'make' xml into php yet, you'll have to hand code page
definitions.
    -Some "secondary" modifications I intend to make to the page render
pipeline (including the ability to insert an XML module definition for
'static' rendering in a page, and almost competely forego a page definition
    -The entityManager and most of its support infrastrucutre
    -A second generation authentication system. If you _really_ need one,
you could probably get R1 Auth/Perm (which are quite effective, and
production tested - but 'simple') working with R2.
    -Some miscellany: I haven't started using Andreas' Request Class (that's
actually next on the list)
    -Some things are still moving targets - I'm sure we'll com across things
we have to change, etc as development progresses.

_but_ and I canot stress this enough:
    -The module structure and method naming scheme is now written in stone:
            Constructor called to 'init' the module, Output() called to (you
guessed it) generate output.

> to get started with it. IF there's a FM and I need to read it, please
point
> me in that direction.

http://www.binarycloud.com/documentation/r1/metabase_docs.phtml

is the metabase documentation. it's quite complete.

Obviously I've had requests to build documentation for bc, which I am
doing - but I'm loth to spend time on that instead of development time to
get the system fully operational. Once that's done I intend to do full
DocBook docs for the project (with some people's help, I'm sure :):)

If you have any questions after the above, I an others are happy to help as
much as we can.

best,

_alex