Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Each component should contain a description of how it can be used in an application #8

Open
froschdesign opened this issue May 11, 2018 · 1 comment

Comments

@froschdesign
Copy link
Member

froschdesign commented May 11, 2018

Problem

At the moment, most components only describe basic usage without integration and use within an application.
This ends up in recurring questions from users how a component can be used in a zend-mvc-based or zend-expressive application.

Examples

Suggestion

We should add for each component a description of how the component can be used in an application. It would be advantageous if we add descriptions for:

  • zend-mvc applications
  • zend-expressive applications
  • a stand-alone usage
  • and other frameworks, libraries etc.

The description should covered only a basic example how a component can be integrated in an application. For examples that illustrate full functionality, the tutorials should be used.
The descriptions for application integrations should only be bundles of individual descriptions, which should already exist in the components. Therefore links must be set for all steps.

Requirements

  • the descriptions for Mezzio must use mezzio-tooling
  • the descriptions for laminas-mvc must use laminas-cli; if corresponding commands are available
  • links must be added which describe the individual steps in detail

Examples

An example can be found at zend-navigation:

Usage in a zend-mvc-based application

The fastest way to get up and running with zend-navigation is:

  • Register zend-navigation as module.
  • Define navigation container configuration under the top-level navigation key in your application configuration.
  • Render your container using a navigation view helper within your view scripts.

https://docs.zendframework.com/zend-navigation/quick-start/#usage-in-a-zend-mvc-based-application

Another example can be found at zend-i18n (WIP):

Usage in a Slim Application

The following examples show two options for using the Translator of zend-i18n in the micro framework Slim.

https://froschdesign.github.io/zend-documentation-showcase/application-integration/slim/

Already present

For laminas-mvc based applications

See also: https://docs.laminas.dev/tutorials/#application-integrations

For Mezzio based applications

Project

There is a project that tracks progress on this topic: https://github.com/orgs/laminas/projects/3

@settermjd
Copy link
Contributor

As zend-mvc and zend-expressive build on these components and people will logically want to use them together, this makes a lot of sense.

@froschdesign froschdesign pinned this issue May 29, 2019
froschdesign added a commit to froschdesign/zend-view that referenced this issue Aug 20, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants