Package Documentation

  • Readme

    PHPFUI Build Status Latest Packagist release

    PHP Wrapper for the Foundation CSS Framework

    PHPFUI, PHP Foundation User Interface, is a 7.1 PHP library that produces HTML formated for Foundation. It does everything you need for a fully functional Foundation page, with the power of an OO language. It currently uses Foundation 6.6 and PHP 7.1 or higher.

    "I was surprised that people were prepared to write HTML. In my initial requirements for this thing, I had assumed, as an absolute pre-condition, that nobody would have to do HTML or deal with URLs. If you use the original World Wide Web program, you never see a URL or have to deal with HTML. You're presented with the raw information. You then input more information. So you are linking information to information--like using a word processor. That was a surprise to me--that people were prepared to painstakingly write HTML."

    Sir Tim Berners-Lee, inventor of the World Wide Web

    Using PHPFUI for view output will produce 100% valid HTML and insulate you from future changes to Foundation, your custom HMTL layouts, CSS and JS library changes. You write to an abstract concept (I want a checkbox here), and the library will output a checkbox formatted for Foundation. You can inherit from CheckBox and add your own take on a checkbox, and when the graphic designer decides they have the most awesome checkbox ever, you simply change your CheckBox class, and it is changed on every page system wide.

    Don't write HTML by hand!

    Usage

    namespace PHPFUI;
    $page = new Page();
    $form = new Form($page);
    $fieldset = new FieldSet('A basic input form');
    $time = new Input\Time($page, 'time', 'Enter A Time in 15 minute increments');
    $time->setRequired();
    $date = new Input\Date($page, 'date', 'Pick A Date');
    $fieldset->add(new MultiColumn($time, $date));
    $fieldset->add(new Input\TextArea('text', 'Enter some text'));
    $fieldset->add(new Submit());
    $form->add($fieldset);
    $page->add($form);
    $page->addStyleSheet('/css/styles.css');
    echo $page;
    

    Installation Instructions

    composer require phpfui/phpfui
    

    Then run update.php from the vendor/phpfui/phpfui directory and supply the path to your public directory / the directory for the various JS and CSS files PHPFUI uses. This will copy all required public files into your public directory. For example:

    php vendor/phpfui/phpfui/update.php public/PHPFUI
    

    The PHPFUI library defaults to your-public-directory/PHPFUI, it can be overridden, but it is suggested to use PHPFUI to keep everything in one place. update.php should be run when ever you update PHPFUI.

    Versioning

    Versioning will match the Foundation versions for Major semantic versions. PHPUI will always support the most recent version of Foundation possible for the Major version. PHPFUI Minor version will include breaking changes and may incorporate changes for the latest version of Foundation. The PHPFUI Patch version will include non breaking changes or additions. So PHPFUI Version 6.0.0 would be the first version of the library, 6.0.1 would be the first patch of PHPFUI. Both should work with any Foundation 6.x version. PHPFUI 6.1.0 would be a breaking change to PHPFUI, but still track Foundation 6.x. PHPFUI 7.0.0 would track Foundation 7.x series.

    Depreciation and Foundation changes

    Since major versions of Foundation have in the past depreciated and obsoleted things, PHPFUI will track the latest version of Foundation for class names and functionality. However, when Foundation makes a breaking change or removes something, PHPFUI will continue to support the old functionality as best as possible in the new Foundation framework. Depreciated classes will be put in the \PHPFUI\Vx namespace (where x would be the prior Major Foundation version containing that feature). So if something gets depreciated in a newer version of Foundation, you simply will need to change your code from \PHPFUI\Example to \PHPFUI\V6\Example. The depreciated namespace will only be supported for one Major version of PHPFUI, so it is recommended you migrate off of it in a timely manor.

    Documentation

    Via PHPFUI/InstaDoc

    Live Examples

    Via PHPFUI/Examples

    Unit Testing

    Full unit testing using phpfui/html-unit-tester

    License

    PHPFUI is distributed under the MIT License.

Namespaces
\PHPFUI\HTMLUnitTester
\PHPFUI\Input
\PHPFUI\InstaDoc
\PHPFUI\PayPal
Classes
PHPFUI\Accordion
PHPFUI\AccordionItem
PHPFUI\AccordionMenu
PHPFUI\AccordionToFromList
PHPFUI\AJAX
PHPFUI\Animation
PHPFUI\Badge
PHPFUI\Bar
PHPFUI\Base
PHPFUI\BlockGrid
PHPFUI\BreadCrumbs
PHPFUI\Button
PHPFUI\ButtonGroup
PHPFUI\Callout
PHPFUI\Cancel
PHPFUI\Card
PHPFUI\Cell
PHPFUI\CloseButton
PHPFUI\Container
PHPFUI\DefaultSessionHandler
PHPFUI\DescriptionDetail
PHPFUI\DescriptionItem
PHPFUI\DescriptionList
PHPFUI\DescriptionTitle
PHPFUI\DrillDownMenu
PHPFUI\DropDown
PHPFUI\DropDownButton
PHPFUI\DropDownMenu
PHPFUI\EMailButton
PHPFUI\Embed
PHPFUI\Equalizer
PHPFUI\FAIcon
PHPFUI\FieldSet
PHPFUI\Form
PHPFUI\FormError
PHPFUI\FroalaModel
PHPFUI\GridContainer
PHPFUI\GridX
PHPFUI\GridY
PHPFUI\Header
PHPFUI\HTML5Element
PHPFUI\HTMLEditorInterface
PHPFUI\HTMLList
PHPFUI\Icon
PHPFUI\IconBase
PHPFUI\Image
PHPFUI\Input
PHPFUI\InputGroup
PHPFUI\KitchenSink
PHPFUI\Label
PHPFUI\Link
PHPFUI\ListItem
PHPFUI\MediaObject
PHPFUI\Menu
PHPFUI\MenuItem
PHPFUI\MultiColumn
PHPFUI\OffCanvas
PHPFUI\Orbit
PHPFUI\OrderableTable
PHPFUI\OrderedList
PHPFUI\Page
PHPFUI\Pagination
PHPFUI\Panel
PHPFUI\PayPalExpress
PHPFUI\PopupInput
PHPFUI\ProgressBar
PHPFUI\RadioTable
PHPFUI\RadioTableCell
PHPFUI\ReCAPTCHA
PHPFUI\ReCAPTCHAv3
PHPFUI\Reset
PHPFUI\Reveal
PHPFUI\Session
PHPFUI\SessionHandler
PHPFUI\SlickSlider
PHPFUI\Slider
PHPFUI\SliderHandle
PHPFUI\SortableTable
PHPFUI\SplitButton
PHPFUI\Sticky
PHPFUI\SubHeader
PHPFUI\Submit
PHPFUI\Table
PHPFUI\Tabs
PHPFUI\TextHelper
PHPFUI\Thumbnail
PHPFUI\TimedCellUpdate
PHPFUI\TitleBar
PHPFUI\ToFromList
PHPFUI\ToolTip
PHPFUI\TopBar
PHPFUI\UnorderedList
PHPFUI\YouTube
© 2020 Bruce Wells
Search Namespaces \ Classes
ConfigurationNumbers (0-9.) only