1
wizanda
Making A Perfect Xoops Blank Module template for All users
  • 2007/3/10 18:45

  • wizanda

  • Home away from home

  • Posts: 1588

  • Since: 2004/3/21


Ok with a couple of people asking how to make modules, and module creators an extra task in learning about Xoops….when modules are easy task in Xoops, very easy

Shall we make an official blank module, with a full open source disclaimer included, nobodies names; just things that make it feel more official, when you are working on any XOOPS projects.

Now there are some bits of code, people have advised lately, for security reasons.
so can we include all details and then make a blank learning module for all XOOPS users.
So instead of people having to dismantle anything or get to grips with a module creator, instead they have an opening page into the world of XOOPS module creation.

It is just up to them then, what they place in smarty and with instruction placed out side of the files such as that PDF, and help docs, they can download everything in one go, so it all took tidy.

Then we can make a complete shoe box package, for everything to go in (we will win the next CMS awards!)

Also then we can collaborate on an offline XOOPS package that explains everything also, that can be the files for our online ones later.

As it is big point many say is missing; what do people think to the idea?

2
jorgebarrero
Re: Making A Perfect Xoops Blank Module template for All users

I like this idea.
------
Jorge Barrero

3
MadFish
Re: Making A Perfect Xoops Blank Module template for All users
  • 2007/3/12 13:50

  • MadFish

  • Friend of XOOPS

  • Posts: 1056

  • Since: 2003/9/27


I like it too.

There is a tutorial by The Cat which gives instructions on how to build a new module, but unfortunately it is very ancient, and I presume that it does not make use of the new code features of XOOPS (whatever they may be :)

If a blank module could be created, together with a decent explanation of the basic architechture and what different bits do, it would be great. I would be willing to help, such as I can (writing up the explanation).

4
wizanda
Re: Making A Perfect Xoops Blank Module template for All users
  • 2007/3/28 10:39

  • wizanda

  • Home away from home

  • Posts: 1588

  • Since: 2004/3/21


While this is on my clipboard =(
/*------------------------------------------------------------------------ //
//                XOOPS - PHP Content Management System                      //
//                    Copyright (c) 2000 XOOPS.org                           //
//                       <https://xoops.org/>  &nbs ... nbsp;   //
//  ------------------------------------------------------------------------ //
//  This program 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) any later version.                                      //
//  You may not change or alter any portion of this comment or credits       //
//  of supporting developers from this source code or any supporting         //
//  source code which is considered copyrighted (c) material of the          //
//  original comment or credit authors.                                      //
//  This program 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.                             //
//  You should have received a copy of the GNU General Public License        //
//  along with this program; if not, write to the Free Software              //
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA //
//  ------------------------------------------------------------------------ */
)


This has a few important changes to what was there before reasons are:
1) that is // = an extra line break each time??
/* words here */ is an better way, also for then closing without making extra spaces also in coding.

2) Next is the spaces, though we have closed it around it's self, it also requires more space per line for size of file, so why do we want 3 lines of extra space in each?

3) Title id of file and editing at the top of each file, this is where XOOPS goes wrong on one hand that is saying this is GPL, yet on other this is author and what was done is final, changes are always happening by the hour, so why store a record that is not nesaccrly correct and increase file size and work.
so better is a current tidly wiki would be nice or full help doc's some how where anyone who uses a module with in XOOPS has a full itemized variable finder, why say those options to be searchable so we can quickly refrence XOOPS core and find errorsd and optimize it better......

Anyways only wanted to post the diclaimer while i am pasting it to increase speed as those line break is a lot of work for anything to read /* */


Happy coding Xoopers

5
agparrot
Re: Making A Perfect Xoops Blank Module template for All users
  • 2007/7/3 14:12

  • agparrot

  • Just popping in

  • Posts: 4

  • Since: 2007/4/2 1


I was also reading the informative tutorial by theCat and translated to english by hsalazar, a PDF file which actually mentions that the various files required for a 'blank module' are attached to the document - although sadly they are not.

I think it would be an excellent starting point for would-be XOOPS developers like myself to have a 'blank XOOPS module' that functions out-of-the box... so that you can install it and use it straight away, even if it is just a module that says 'Hello World!' when you turn its block on.

Personally I am trying to create a module so that I can break up content using the DHINFO module - I have four content blocks, and I want to show them in two separate screens of two blocks, as left-hand and right-hand columns - if I had two ' blank modules' that I could point the DHINFO Blocksadmin at, I'd be laughing.

Instead my relative noobness with xoops, and time constraints making it difficult to pick apart existing modules, mean I'm relegated to featuring my blocks one at a time.

I'd really be interested in helping to document a blank module though, from a beginners point of view, to ensure that the documentation and blank module are accessible to those of us who haven't spent a lot of time in the guts of xoops.

6
chippyash
Re: Making A Perfect Xoops Blank Module template for All users
  • 2007/7/3 17:06

  • chippyash

  • Friend of XOOPS

  • Posts: 501

  • Since: 2004/1/29


Um, you could always use my ModGen module generator to create a blank module (or perhaps one with one config item, one admin option and one user side option.)

Then go in and edit the files to comment them. The documentation that comes with ModGen also will go some way to helping you additionally document the files.

When you have finished I'd be really interested in publishing the work under the Module Development team banner.

Hope it helps

7
BlueStocking
Re: Making A Perfect Xoops Blank Module template for All users

by akitson on 2007/7/3 12:06:22
How about a link, it sounds like something I would like.
(or is it preferred I search for it)

Thanks
https://xoops.org/modules/repository .. It is time to get involved - XOOPS.ORG

8
davidl2
Re: Making A Perfect Xoops Blank Module template for All users
  • 2007/7/3 17:29

  • davidl2

  • XOOPS is my life!

  • Posts: 4843

  • Since: 2003/5/26



9
BlueStocking
Re: Making A Perfect Xoops Blank Module template for All users

https://xoops.org/modules/repository .. It is time to get involved - XOOPS.ORG

10
davidl2
Re: Making A Perfect Xoops Blank Module template for All users
  • 2007/7/3 17:39

  • davidl2

  • XOOPS is my life!

  • Posts: 4843

  • Since: 2003/5/26


Also correct

Login

Who's Online

70 user(s) are online (39 user(s) are browsing Support Forums)


Members: 0


Guests: 70


more...

Donat-O-Meter

Stats
Goal: $100.00
Due Date: Jul 31
Gross Amount: $0.00
Net Balance: $0.00
Left to go: $100.00
Make donations with PayPal!

Latest GitHub Commits