Is there some documentation for mod writers / theme designers ready?

dorje

  • Krabi krabong: the wedge of martial arts. :P
  • Posts: 97
Ok, we can't have a look at wedge at the moment.... But... Is there some document to read / study? Just to be ready - I can't stay there and wait without doing nothing! :yahoo:

Another question: are there many differences between the core smf db tables and the wedge one? I mean - I know that wedge has many feature smf haven't - but I guess if the "forum stuff" tables structure are the same. :)
Krabi Krabong & programming :D

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278
When we unite against a common enemy that attacks our ethos, it nurtures group solidarity. Trolls are sensational, yes, but we keep everyone honest. | Game Memorial

dorje

  • Krabi krabong: the wedge of martial arts. :P
  • Posts: 97
Re: Is there some documentation for mod writers / theme designers ready?
« Reply #2, on March 30th, 2011, 10:59 AM »
Quote from Arantor on March 30th, 2011, 10:40 AM
No, there isn't. Kind of hard to document something that is a moving target and being modified regularly as it evolves...
That's right, I've not consider that. :)
Quote from Arantor on March 30th, 2011, 10:40 AM
There are quite a few differences, and likely there will be more as time goes on.
Ok... I'll wait until I become a "wedge friend" :eheh:

Nao

  • Dadman with a boy
  • Posts: 16,079
Re: Is there some documentation for mod writers / theme designers ready?
« Reply #3, on March 30th, 2011, 12:21 PM »Last edited on March 31st, 2011, 02:47 PM by Nao/Gilles
Welcome to the world of "feature hot", as opposed to feature frozen :eheh:

For instance, I started redoing the CSS system in mid-January, and I finished a few weeks ago and it's still not considered 'stabilized' (I'm still working, as of this moment, on improving class inheritance.)
Because of the rewrite, it means you can't import your theme CSS "like that". You'll have to rewrite it entirely (or, at best, to do a long series of automatic search & replace sessions, which I myself did to rewrite the SMF css files.)
Since right now I could just call it quits at any point in time and just revert back to the SMF system (which I'll never do but it's an example :P), there's no point in documenting it too much.
Hopefully I'll be able to write said docs just by going through Class-CSS.php once it's 100% stable :P

dorje

  • Krabi krabong: the wedge of martial arts. :P
  • Posts: 97
Re: Is there some documentation for mod writers / theme designers ready?
« Reply #4, on March 30th, 2011, 12:45 PM »Last edited on March 31st, 2011, 02:47 PM by Nao/Gilles
Quote from Nao/Gilles on March 30th, 2011, 12:21 PM
Welcome to the world of "feature hot", as opposed to feature frozen :eheh:
I'm going to love it, I know! :D
Quote from Nao/Gilles on March 30th, 2011, 12:21 PM
Because of the rewrite, it means you can't import your theme CSS "like that". You'll have to rewrite it entirely (or, at best, to do a long series of automatic search & replace sessions, which I myself did to rewrite the SMF css files.)
Not a problem: I'm planning to write my themes "from scratch". :cool:
Quote from Nao/Gilles on March 30th, 2011, 12:21 PM
Hopefully I'll be able to write said docs just by going through Class-CSS.php once it's 100% stable :P
:yahoo:

Sound's great.  :eheh:

Nao

  • Dadman with a boy
  • Posts: 16,079

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278

DoctorMalboro

  • I like rounded borders.
  • Posts: 316

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278
Re: Is there some documentation for mod writers / theme designers ready?
« Reply #8, on March 30th, 2011, 01:57 PM »
There are sprite images, but they're not stupid ones. The bbcode images, for example, is a sprite - but they can be overridden. The little images by menu icons (like here) are a single sprite, but again it's possible to override that to individual images.

But the core of the default theme is not to use massive images like that where possible, and use CSS normally to achieve things.

That said, it's not a huge amount of work if you want to revert things; one of the things Nao did was create a meta code of sorts, <we:cat> and <we:title> that get turned in to the relevant divs and h3 tags that make the cat and title bars. Here's where it's neat: that's defined in the settings of a theme or theme variation, which means the templates all use <we:*> (so it's trivial to keep consistency in add-ons) and the theme dictates the code it wants to use, meaning you could use Curve's HTML if you wanted. Not that it would be a good idea... but you could if you wanted.

dorje

  • Krabi krabong: the wedge of martial arts. :P
  • Posts: 97

DoctorMalboro

  • I like rounded borders.
  • Posts: 316

Arantor

  • As powerful as possible, as complex as necessary.
  • Posts: 14,278