Ferreteria: Difference between revisions

From Woozle Writes Code
Jump to navigation Jump to search
(HyperAdmin)
(reorg)
Line 1: Line 1:
[[Ferreteria]] is a web application framework I'm writing in PHP. It originally emerged from writing [[VbzCart]], when I realized a lot of the classes and techniques I'd created (starting with the database classes) could be used for other applications as well.
<hide>
[[page type::article]]
[[thing type::software]]
[[thing type::project]]
[[software type::library]]
[[language::PHP]]
[[category:software]]
</hide>
==About==
'''Ferreteria''' is a code library that provides a basic [[application framework]] along with some utility functions that can be used separately. It was originally written for [[VbzCart]], but became useful in its own  right as it developed. The name literally means "hardware" in Spanish; I used it because I came across the word in a hardware store full of useful tools, which made it seem somehow appropriate as a name for a software toolkit, and also because I seem to be using the affix "ferret" in a lot of my software projects.


Because it does not use JavaScript (JS), it is very fast; response-times tend to be comparable to a "single-page app" framework written in JS, except that the initial load is as quick as subsequent reloads and all of the navigation links are bookmarkable.
It is written in [[PHP]], but should be portable to other languages without too much difficulty.
==Features==
{|
* '''User management'''
|-
** log-in control: email-based account creation, password reset
|
** user-group assignment, group-permissions assignment
==Pages==
* '''State persistence via URL'''
* [[/install]]
** The only cookie stored is a single "session" cookie, which usually just stores the minimum needed for session security.
* [[/errors]]: elaboration on various error messages
*** Most app-state data is stored in the URL path, without even using the <code>?query</code> part of the URL, for practical and aesthetic reasons.
* [[/archive]]: obsolete pages
* '''Database wrappers'''
* [[/modules]]: available drop-in modules (includes table design pages)
** classes for different types of tables, records
===versions===
** classes for handling forms, controls, data fields
versions 1-3 need to be renamed to 0.1-0.3 because they're all pre-release
** functions for specific tables can be built by descending from more general classes
** '''[[/v0.4|version 0.4]]''': recordsets split into single-row records and multiple-row recordsets; using status objects more
** URL-linkable tables, records
** '''[[/v0.3|version 0.3]]''': had to temporarily abandon several weeks of work on this in January 2019
==Reference==
*** [[/v0.3/class]]es
* {{htyp}}: official documentation
*** [[/v0.3/fx]] (functions)
* {{l/htw|HyperAdmin}}: an early (2005) description of what eventually became Ferreteria's login system
*** [[/v0.3/usage/forms]]: early v3 usage documentation, probably needs update
** '''[[/v2|version 2]]''', 2017-2019: basically Ferreteria 1 with db.v2
*** [[/v2/class]]: class structure
*** [[/v2/usage]]: how to do things in Ferreteria, how the pieces work
** '''[[/v1|version 1]]''' never really had much documentation
*** [[/v1/usage/forms]]
| valign=top |
==Apps/Applets==
* Greenmine:
** [[WorkFerret]]
** [[FinanceFerret]]: in redevelopment
* [[VbzCart]]: online retail
|}
==Links==
===Official===
* [https://gitlab.com/woozalia/ferreteria GitLab]: official code repository
* [http://rm.vbz.net/projects/ferreteria Redmine @ vbz]: official project tracker

Revision as of 16:43, 29 February 2020

<hide> page type::article thing type::software thing type::project software type::library language::PHP </hide>

About

Ferreteria is a code library that provides a basic application framework along with some utility functions that can be used separately. It was originally written for VbzCart, but became useful in its own right as it developed. The name literally means "hardware" in Spanish; I used it because I came across the word in a hardware store full of useful tools, which made it seem somehow appropriate as a name for a software toolkit, and also because I seem to be using the affix "ferret" in a lot of my software projects.

It is written in PHP, but should be portable to other languages without too much difficulty.

Pages

versions

versions 1-3 need to be renamed to 0.1-0.3 because they're all pre-release

Apps/Applets

Links

Official