YJ Module Engine features:Back to menu
- YJME is using Joomla MVC Structure
- Edit Module template in module manager New!
- Create new module template in module manager New!
- Select default module stylesheet. New!
- Edit module stylesheet trough module manager New!
- Upload new stylesheet trough module manager New!
- Create new stylesheet trough module manager New!
- Choose news item source, Joomla or K2 New!
- Select news items from all or specific Joomla/K2 category
- Select specific news items from Joomla/K2
- Drag and drop news item reorder
- Choose default news item image for K2 (xs,small,medium,large xlarge)
- Restrict display of Joomla frontpage news items New!
YJ Module Engine News Item settings: Back to menu
- Redirect to login page if news item access level (Joomla or K2) is set to Registered or higher New!
- Number of news items restriction
- Number of news item intro text characters
- Show / Hide Item title
- Show / Hide Item Author ( if K2 link to author page)
- Show / Hide
- Display author username or real name
- Show / Hide Intro Image
- Intro image position ( left , right , top)
- Intro image height and width setting
- Show / Hide Category title ( Link to category)
- Show / Hide Create date
- Show / Hide Intro text
- Show / Hide read more link
Isn’t that a module! Whit these options you can do some nice Joomla magic. But like said those are only options. Let us talk about the actual news engine and explain why it is so special.
News Engine: Back to menu
Let's say, you want to create another module from YJME. As developer you know the steps , copy the module, rename module.php file, rename xml file, rename language.ini file, change php class , change sql query, change variables, and the most annoying one is rename all instances of module name within files mentioned.
We do understand that instances in xml files and language file should be renamed since they are not dynamic. But php files could do better right? If you are using YJME you don't have to look inside module.php or helper.php at all.
To understand better here is how I am making new module instance, and I clocked myself at 46sec. Yes! 46 seconds took me to make a installation file for a completely new YJME powered module.
Creating new module from YJME : Back to menu
- Rename YJ_Module_Engine.zip to my new module name. Example , mod_yj_module.zip
- Open the zip ( if possible use winRar ) , no need to extract.
- Within zip rename mod_yjme.php , mod_yjme.xml and en-GB.mod_yjme.ini ( if Joomla 1.6 and up also rename en-GB.mod_yjme.sys.ini) to mod_yj_module keep the extension as is.
- Open en-GB.mod_yj_module.in rename all instances of mod_yjme to mod_yj_module ,
- Find Youjoomla Module Engine Module for Joomla 1.5x and change to your own title
- Open mod_yj_module.xml and rename all instances of mod_yjme to mod_yj_module
- change <name>Youjoomla Module Engine Module</name> to your module name.
- Your zip file will prompt you to save the changes to your file. Click yes.
All done! You can install your new module . This is only possible in YJME because it is using same variables and classes for both news engines(Joomla or K2) Functions structure is redone to let you use same function when you need it( no functions names clashing).
News sql queries are separated from each other and are requested only when needed, and the best part is , it pulls the actual module name from folder where it resides and redirects all your scripts and module elements based on the folder name. But that is not all.( lol I sound like one of those shopping commercials. Moving on... ).
News item images: Back to menu
The YJME is smart to search through your Joomla news items and pick up first image it finds. If there is none in intro text it will look in full text. Plain and simple. What about K2 images? We all love image sizes variety that K2 has to offer, but I want to present the K2 news items in a slider I am making for YouFact joomla template and none of my image sizes fits the slider size. I would have to do some image size adjustment in K2 settings and re-upload the images again. Hmm. I don’t like that.
No need to do any of mentioned changes if you are using YJME . Leave your K2 images as they are and do this instead:
- Place new image in K2 news item intro text
- Under the image in intro text add read more
- Under the read more add your K2 news item text
- In K2 category setting set Hide intro text to Yes.
Now the slider will pick up the image from K2 intro text because it has precedence over default K2 images, and if you follow the link from slider to K2 you will see your news item with K2 image assigned and without the image from intro text. Demo of this setting can be seen on our new Joomla Template YouFact that is using You Fact News Slider powered by YJME .
Module parameters: Back to menu
To make it easier for anyone who would like to create own module based on YJME we have separated the default engine parameters and news item parameters. News item parameters are located in mod_yjme/yjme/params/params.php file and they are changeable. Meaning you can remove them or add your own without affecting the actual news engine.
Please do not forget to edit/remove the xml param tags for the parameters changed/added. Also remove the conditions for the parameters in module template default.php file.
Please note that all module files are very well commented and we did our best to explain the usage of all variables/functions/parameters used.
Module templating:Back to menu
By now you have probably heard about module templating. Joomla developers are used to MVC and its usage but for those who do not know what this is here is simple 1on1 in laic terms:
Module templating is nothing else but the html output of your module settings. In Joomla modules, that output file is usually located in module_name/tmlp/default.php. The file name or folder can be different and its name and location are decided by developer.
In YJME and all Youjoomla MVC modules, template is always located here: module_name/tmpl/Template_Name/default.php.
In your YJME module parameters you will see parameter name Select default module template and default selected item from the dropdown select box is Default ( Stands for module_name/tmpl/Template_Name/ ).
With this explained, you can easy understand what parameters, Edit Template and Create Template are there for. They give you the freedom to edit the current module output or create own without going through module folders and files.
If you choose to create new module template the creation process makes a copy of Default module template and assigns the name that you have previously chosen in Create new template window.
After you hit save you will be presented with Creating New Template prompt
Few seconds later you will see Template created message
To edit your module template choose Edit Template button. You will see a modal window with template editor that also has build in CodeMirror code-editor. On top right select template name that you would like to edit and do your magic.
What to add/change you ask? Default module template or the one that you have created will have commented lines on top of the file explaining in detail how to output any of news items parameters and what type of loop to use.
As first one from top you will see //Title: $yj_get_items['item_title'] So by simply echoing this variable within the loop(see line 18 in module template file)
you will see your news items title in your module frontend. We leave you to play around with these settings and make them your own. The possibilities are endless and with some imagination you can make very special Joomla module based on YJME.
YJME CSS control:Back to menu
Just like module templating , you can edit default module CSS file, create own or even upload new one.
The editing process is same as template editing and if you came this far in the tutorial we will not bother you with same explanation. Simply follow the instructions after clicking the upload/edit/create CSS buttons and you will be set in few seconds.
Usage and license:Back to menu
Demo Download Back to menu