BC Lower Case Url Alias
This bundle implements a solution to provide eZ Publish Platform / eZ Platform url alias
transformation configuration necessary to transform new content created or modified
url aliases to lower case separated by underscore or dash characters., (*1)
Version
-
The current version of BC Lower Case Url Alias is 0.1.2, (*2)
-
Last Major update: March 09, 2017, (*3)
Copyright
-
BC Lower Case Url Alias is copyright 1999 - 2017 Brookins Consulting, (*4)
-
See: COPYRIGHT.md for more information on the terms of the copyright and license, (*5)
License
BC Lower Case Url Alias is licensed under the GNU General Public License., (*6)
The complete license agreement is included in the LICENSE file., (*7)
BC Lower Case Url Alias is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License or at your
option a later version., (*8)
BC Lower Case Url Alias is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details., (*9)
The GNU GPL gives you the right to use, modify and redistribute
BC Lower Case Url Alias under certain conditions. The GNU GPL license
is distributed with the software, see the file LICENSE., (*10)
It is also available at http://www.gnu.org/licenses/gpl.txt, (*11)
You should have received a copy of the GNU General Public License
along with BC Lower Case Url Alias in in the LICENSE file., (*12)
If not, see http://www.gnu.org/licenses/., (*13)
Using BC Lower Case Url Alias under the terms of the GNU GPL is free (as in freedom)., (*14)
For more information or questions please contact: license@brookinsconsulting.com, (*15)
Requirements
The following requirements exists for using BC Lower Case Url Alias bundle:, (*16)
eZ Publish version
-
Make sure you use eZ Publish version 5.x (required) or higher., (*17)
-
Designed and tested with eZ Publish Platform (With Legacy) 2015.01.03 and PHP 5.6.30+, (*18)
PHP version
- Make sure you have PHP 5.x or higher.
Features
SlugConverter Classes
This solution provides the following ezplatform slug converter classes:, (*19)
- BrookinsConsulting\BcLowerCaseUrlAliasBundle\Core\Persistence\Legacy\Content\UrlAlias\BcLowerCaseUnderscoreUrlAliasSlugConverter
- BrookinsConsulting\BcLowerCaseUrlAliasBundle\Core\Persistence\Legacy\Content\UrlAlias\BcLowerCaseDashUrlAliasSlugConverter
Dependencies
- This solution depends on eZ Platform
- This solution depends on symfony/symfony
These dependencies are documented in greater detail within the bundle's composer.json file, (*20)
Use case
This solution was created to provide content url aliases which are similar
to the eZ Publish Legacy 3.x url aliases (lowercase and separated by underscores)., (*21)
Installation
Bundle Installation via Composer
Run the following command from your project root to install the bundle:, (*22)
bash$ composer require brookinsconsulting/bclowercaseurlaliasbundle dev-master;
Bundle Activation
Within file app/AppKernel.php method registerBundles add the following into the $bundles = array( variable definition., (*23)
// Brookins Consulting : BcGitHubStarsBundle Requirements
new BrookinsConsulting\BcLowerCaseUrlAliasBundle\BcLowerCaseUrlAliasBundle(),
Clear the caches
Clear Symfony caches (Required)., (*24)
php bin/console cache:clear;
Usage
The solution is configured to work virtually by default once properly installed., (*25)
Warning
Remember to backup your installations database, source code and var directory content before using this solution!
Remember much like legacy implementations this solution should be used before content is created from a clean installation.
Otherwise you may need to re-publish all content objects upon installation via script or manually in order to ensure all content objects use the same url alias transformation convention.
Alternate Configuration (Optional)
If you prefer the lower case urls separated with underscores you need do nothing as this is the supported default once this bundle is activated., (*26)
If however you prefer the lower case urls separated with dashes (an optional configuration) you will need to override the default parameter class configuration with the following within your own app/config or your own prioritized bundle configuration (separate)., (*27)
Example: Change the class from parameters yaml configuration as follows, (*28)
parameters:
ezpublish.persistence.slug_converter.class: BrookinsConsulting\BcLowerCaseUrlAliasBundle\Core\Persistence\Legacy\Content\UrlAlias\BcLowerCaseDashUrlAliasSlugConverter
Further Expansion and Configuration
Worth noting that this bundle provides a decent example implementation which can simply be copied and or modified to meet your own specific requirements and needs., (*29)
You could easily use this bundle as an example on how to override yaml parameters, class overrides and url alias slug converter configurations., (*30)
With this knowlege you could create your own url alias slug converter configuration classes representing different website / app requirements., (*31)
Testing
The solution is configured to work once properly installed and configured., (*32)
Note: At the time of writing xss testing has not been implemented nor proper unit testing., (*33)
Troubleshooting
Read the FAQ
Some problems are more common than others. The most common ones are listed in the the Resources/doc/FAQ.md, (*34)
Support
If you have find any problems not handled by this document or the FAQ you can contact Brookins Consulting through the support system: http://brookinsconsulting.com/contact, (*35)
Wallogit.com
