Download the PHP package shel/asset-names without Composer
On this page you can find all versions of the php package shel/asset-names. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
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 asset-names
Asset names for Neos CMS
Installing this package will change the naming behavior for files when publishing assets in Neos CMS.
By default Neos CMS will create a symlink in the public Web folder to the file stored in the private Data/Persistent
folder. These symlinks to images and other assets will have the filenames they got when they were uploaded.
New behavior: The symlinks to these assets will have a filename based on their title which can be set in the Media Module.
Advantages
- You can optimize the filenames for SEO purposes in the
Media Module. - The actual file name stored in the database is not changed.
- Old filenames will still work until the
Web/Resourcesfolder is cleaned up.
Caveats
- The final filename will be run through
slugifyto prevent problematic characters in the filename. - The actual file name stored in the database is not changed. Therefore there is an additional query to the database to generate the file name when the public uri is requested. This might be optimized in the future.
In my tests publishing ~1000 resources with this plugin took ~2.5s compared to ~1s without this feature.
How to use it
- Install the package via composer
composer require --no-update shel/asset-namesin your site package. - Run
composer updatein your project's root folder. - Run
./flow resource:publish. - Change an assets title in the media module and check the resulting filename in the preview.
Adapt the filename schema
You can customise the filename creation via your Settings.yaml.
Add the following snippet to your configuration and adapt it to your needs:
It's recommended to keep the width and height suffix.
What the package cannot do yet
It currently doesnt work when not using the provided symlink target.
If you use the copy target or some cloud based filesystem you can extend those targets the same way and provide the change as PR to this package.
Future plans
- This feature should be in the Neos CMS core at some point.
- This package is meant to find the best implementation and also support older Neos versions until it's part of the core.
Contributions
Contributions are very welcome!
Please create detailed issues and PRs.
If you use this package and want to support or speed up it's development, use Githubs sponsor button or get in touch with me
License
See License
