Download the PHP package sitegeist/fluid-components without Composer
On this page you can find all versions of the php package sitegeist/fluid-components. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sitegeist/fluid-components
More information about sitegeist/fluid-components
Files in sitegeist/fluid-components
Package fluid-components
Short Description Encapsulated frontend components with Fluid's ViewHelper syntax
License GPL-2.0-or-later
Homepage https://github.com/sitegeist/fluid-components
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package fluid-components
Fluid Components
This TYPO3 extensions puts frontend developers in a position to create encapsulated components in pure Fluid. By defining a clear interface (API) for the integration, frontend developers can implement components independent of backend developers. The goal is to create highly reusable presentational components which have no side effects and aren't responsible for data acquisition.
⬇️ TL;DR? Get started right away ⬇️
What does it do?
Fluid templates usually consist of three ingredients:
- Templates,
- Layouts, which structure and wrap the markup defined in the template, and
- Partials, which contain markup snippets to be reused in different templates.
In addition, ViewHelpers provide basic control structures and encapsulate advanced rendering and data manipulation that would otherwise not be possible. They are defined as PHP classes.
The extension adds another ingredient to Fluid: Components.
What are components?
Fluid components are similar to ViewHelpers. The main difference is that they can be defined solely in Fluid. In a way, they are quite similar to Fluid's partials, but they have a few advantages:
- They provide a clear interface via predefined parameters. The implementation is encapsulated in the component. You don't need to know what the component does internally to be able to use it.
- With semantic component names your templates get more readable. This gets even better with atomic design or similar approaches.
- They can easily be used across different TYPO3 extensions because they utilize Fluid's namespaces. No partialRootPath needed.
How do components look like?
The following component implements a simple teaser card element:
Components/TeaserCard/TeaserCard.html
Use the following code in your template to render a teaser card about TYPO3:
The result is the following HTML:
(improved indentation for better readability)
Getting Started
-
Install the extension either from TER or via composer:
-
Define the component namespace in your ext_localconf.php:
Use your own vendor name for
VENDOR, extension name forMyExtension, and extension key formy_extension. -
Create your first component in EXT:my_extension/Resources/Private/Components/ by creating a directory MyComponent containing a file MyComponent.html
-
Define and apply your component according to Extended Documentation can be helpful as well.
- Check out Fluid Styleguide, a living styleguide for Fluid Components, and Fluid Components Linter to improve the quality and reusability of your components.
If you have any questions, need support or want to discuss components in TYPO3, feel free to join #ext-fluid_components.
Why should I use components?
- Components encourage markup reusage and refactoring. Only the component knows about its implementation details. As long as the interface stays compatible, the implementation can change.
- Components can be a tool to enforce design guidelines. If the component's implementation respects the guidelines, they are respected everywhere the component is used. A helpful tool to accomplish that is the corresponding living styleguide: Fluid Styleguide.
- Components formalize and improve communication. Frontend developers and integrators agree on a clearly defined interface instead of debating implementation details.
- Components reduce dependencies. Frontend developers can work independent of integrators and backend developers.
Extended Documentation
Feature References
- ViewHelper Reference
- Data Structures
- Links and Typolink
- Files and Images
- Translations
- Navigations
- DateTime
- Slots
- Component Prefixers
- Component Settings
How-To's
- Usage with Forms
- Add auto-completion in your IDE
- Updating from 1.x
- Mitigating XSS issues with 3.5
Authors & Sponsors
- Ulrich Mathes - [email protected]
- Simon Praetorius - [email protected]
- All contributors
The development and the public-releases of this package is generously sponsored by my employer https://sitegeist.de.
