Extension talk:Winter

Improving and Extending Winter
Winter is still in active development. If you spot any bugs or have ideas to add any new features or make other improvements, please feel free to comment.

addFunction method
New functions can be added via the hooking method addFunction provided by the Winter parser $Winter->addFunction('Winter_function_name','PHP_function_to_call');

PHP_function_to_call will take a single parameter: an array of the parameters of the Winter function. The value of the 0 index is the name of the calling function (e.g. 'Winter_function_name'). This allows for the same PHP function to handle multiple hooks for Winter functions.

v1.0
All bugs below from v1.0 have been fixed in v1.1 [2 bugs added 05:01, 18 November 2005 (UTC)]
 * nested functions with spaces inbetween the function name and the first pipe cause a time out error. ex: {#var | a  }} .  a work around for this bug is to omit the space.  The followin code works  '{#var| a  }}  This bug was dure to an error in a regular expression and has been fixed for later versions
 * the operator != does not always work as expected. Current work around is to avoid using this operator.  This error was caused because the mediawiki parser prepends an &amp;nbps; to ! if there is a space inbetween it and a |

Questions

 * I tried to run the extension on Mediawiki 1.5.3. It seemed to work, until i tried nested functions like the Example 1 from the mainpage. I always get Error messages about Timouts. Now the server is killed - though i am not sure, if the extension has something to do with it, but it seems so. Any ideas, what i can do about it? mail: tiefling at gmx.de -- Phonkeal


 * strange.. I haven't tested it on 1.5.3 but it works fine on 1.5.2 . You copied example 1 directly and it's not working? Frantik 23:33, 17 November 2005 (UTC)
 * Your email revealed a bug in Winter code.. it doesn't like it if you put a space in between the function name and the first pipe (|). This has been fixed for future releases Frantik 05:01, 18 November 2005 (UTC)

How to enable this extension?
I'v dropped it into extensions directory, but it does not seem to work. It's mediawiki 1.5.2.


 * you need to add require_once("extensions/Winter.php"); to the bottom of LocalSettings.php

Small improvements
Hello, your extension ist very good. But I have a few small improvements still.
 * 1) It could be contained version information
 * 2) The function "wfWinterScriptExtension" needs a return value, since otherwise different extension could not fade in itself into the hook.

to 1. the code

// Process page text using Winter scripting engine function wfWinterScriptExtension( &$parser, &$text) { global $Winter;

$text = $Winter->processText($text);

return true; }

to 2. the code

$wgExtensionCredits['parserhook'][] = array(                                   	    'name' => 'Winter (Wiki INTERpreter)',	                                    'author' => 'frantik',	                                    'url' => 'http://meta.wikimedia.org/wiki/User:Frantik/Winter',                                            'description' => 'Is an extension which adds an interpreted language to Mediawiki pages.',                                            'version' => '1.3.1');

--Thomas Klein 18:40, 11 December 2005 (UTC)


 * Cheers for the advice. I will include these changes in the next update.  Glad you like the extension :) --Frantik 14:23, 14 December 2005 (UTC)

Problems with tables in templates
I have a template with a table. So lines in the table don't include in the table, if the parameter is null.

Template source:

Template call:

What is wrong? --Thomas Klein 21:12, 11 December 2005 (UTC)


 * You need to tell Winter the default values of any value that may be NULL. Include this text at the top of your template page:


 * --Frantik 14:18, 14 December 2005 (UTC)


 * That works!


 * style="background:#FAFAF5"
 * }
 * But not that,


 * }
 * and not that

{{#if| | {{#if| {{{Besonderheit}}} | Why not? --Thomas Klein 21:56, 14 December 2005 (UTC)
 * Besonderes:||
 * style="background:#FAFAF5" }}
 * }


 * It seems as if not all of the code is passed to Winter if it is inside a table. I'll try to see if I can make this work as I'm sure it would be a popular feature --Frantik 23:02, 14 December 2005 (UTC)


 * Ok, I see the problem. The closing }} for the if statement needs to be on a new line, otherwise mediawiki assumes it is part of the table definition.  Try this:

{| border="0" cellpadding="2" cellspacing="1" style="background:#8CAFE6; float:right; margin-left:15px; margin-top:10px; margin-bottom:10px" width="30%" ! colspan="2" align="left" | Mitarbeiter
 * style="background:#FAFAF5"
 * Name:||
 * style="background:#FAFAF5"
 * Tel:||
 * style="background:#FAFAF5"

{{#if| {{{Besonderheit}}} | }}
 * Besonderheit: ||{{{Besonderheit}}}
 * style="background:#FAFAF5"


 * --Frantik 06:30, 15 December 2005 (UTC)


 * That is ok, but not if i use the varibale more than one. --Thomas Klein 07:53, 16 December 2005 (UTC)
 * What do you mean? Can you give an example? --Frantik 11:23, 17 December 2005 (UTC)

nowiki is not honored!
This is really a minor nit -- so far, I love Winter! But I was making an example page for my users, showing entered versus displayed and it appears that Winter merrily cruises right through  tags! So I went to see how you made your Winter code show up, and it appears your examples have formatting inside, which must keep Winter from taking action. --Bytesmiths 05:19, 20 December 2005 (UTC)
 * The example code displays here on meta.wikimedia.org because Winter isn't installed. Nowiki isn't honored because Winter isn't part of the wiki rendering engine, though I can see how there is a need for a way to display Winter code on a wiki that is running Winter so i'll have to add a command --Frantik 16:19, 21 December 2005 (UTC)

Fatal error
returned Fatal error: Call to undefined function: hasparamnum in /wiki/extensions/Winter.php on line 602

Thought you'd want to know. Simetrical 06:08, 9 January 2006 (UTC)


 * To clarify, I was trying to create a function that, given an input x, would go to the page "Units:x" (Units: is a namespace on the wiki I'm using) and return all text between "|dictionary=                 " and "            |category=" (with no quote marks in the file). Simetrical 06:22, 9 January 2006 (UTC)


 * oops, there is a bug in the strpos code. I fixed it for the next release.  The syntax of your function definition has quite a few errors in it though.  You probably only want two } after each var call.. the set of 4 is actualy closing the strpos function before you tell it the string.. ie: your code translates to this:  (strpos (var 1)) "string") when it should be (strpost, (var 1) "string) Frantik 02:02, 12 January 2006 (UTC)
 * actually, i see what you're trying to do.. you need to use a 'trans:' call to get the text of the wiki page. you also might want to use escape characters because mediawiki might try to trans  instead of trans:(pagenane). Frantik 02:59, 12 January 2006 (UTC)

Thanks. I figured I may well have been doing something wrong, but I'm glad to hear I could help you fix a bug as well. What do you mean by a trans: call? , for instance, just gives a redlink to Template:Trans:User:Frantik, and Help:Template makes no mention of a trans: prefix. Simetrical 05:20, 12 January 2006 (UTC)
 * You need to transclude the page. it's not done by trans: like i thought, just by prepending a : to the link (eg  ) Frantik 09:01, 12 January 2006 (UTC)
 * Actually, transclusion works differently depending on the namespace.. your use is probably fine, though you still may want to use escape characters [Transclusion_costs_and_benefits] Frantik 09:28, 12 January 2006 (UTC)

Inefficiency
How resource-efficient is Winter? I would think a string-position search should take near-zero processing time regardless of string length, but a strpos of the form seems to take forever if I don't get a server error. I'm worried that I'll exceed my server capacity if I use too many of these commands. Is this normal? Simetrical 06:51, 9 January 2006 (UTC)
 * Hmm I would expect it to take very little time as well. let me investigate.  Frantik 01:50, 12 January 2006 (UTC)
 * I fixed this problem as well.. the error was created when strpos returned false. Your query was returning false due to your use of whitespace; strpos was searching for word&lt;/pre> and not just word.    try this:   instread.  Unline most languages, whitespace IS important in Winter.  This is because certain text formatting will cause Mediawiki to add html to it, before Winter sees the code --Frantik 02:15, 12 January 2006 (UTC)
 * On a more general note, I've tried to make Winter as resource efficient as possible. I also have made it a goal to never allow Winter to cause a server 500 error.. if you ever get one please let me know how you got it so i can fix it :) Frantik 02:41, 12 January 2006 (UTC)

Hmm, I've gotten a number of server 500 errors. I'll be sure to make a note of them in the future and tell you.

As for the specific strpos I mentioned, would adding quotes to the string allow me to split it up across lines? It's much easier to read that way for more complicated functions. Simetrical 05:22, 12 January 2006 (UTC)
 * since the problem is wikimedia adding formatting before winter sees it, you might try putting the code inside of a &lt;nowiki> block. Frantik 09:05, 12 January 2006 (UTC)

Problems with Variablename
I have problems with variable some minus sign to have (example: super-param). This variables are not correctly recognized! --Thomas Klein 07:56, 6 February 2006 (UTC)
 * Only alphanumeric characters and _ are allowed in a variable name if you want to use the variable shortcut syntax (ie as opposed to
 * try using "super_param" instead :)
 * Frantik 18:16, 11 February 2006 (UTC)
 * With _, i have the same problem. --Thomas Klein 11:43, 14 February 2006 (UTC)
 * When I add this to a page, it displays 2
 * I'm not sure why _ isn't working on your system. --Frantik 08:07, 16 February 2006 (UTC)
 * I'm not sure why _ isn't working on your system. --Frantik 08:07, 16 February 2006 (UTC)

Simple questions
I have some questions. Can Winter variable be a string or only number? When I write template in Winter, can i use template parametr as Winter variable?
 * variable names and values can be numbers or strings. You can use template parameters just you you normally would in templates:
 * --Frantik 10:41, 24 March 2006 (UTC)

Arrays
I'm trying to get array functionality out of winter. I have a template with the following code in it:

The line in question here is the one with the wiki Image markup. What I'm looking to do is access the template parameter number (i*height)+j+3. This is just the math needed to store a matrix in a 1d array, with an offset since params 1 and 2 are width and height. Right now a call like this:

Evaluates like this: If only those were parsed by the template I'd have my solution! I already tried using ^( instead of ^_(, but that causes the curly braces to be interpreted wrong. Thanks in advance for your help.
 * this problem is occuring because the triple brace variable replacement only occurs once before control is passed to Winter. The best way to solve this is to set the parameters to Winter variables.  Unfortunately you'll have to set them all explicitly, so the code will not allow for an unlimited amount of parameters.


 * Try this:


 * --Frantik 08:48, 11 August 2006 (UTC)

Dynamic categories
I've been using (and loving) Winter now, but came across something I just haven't been able to do. In Winter, this code:

doesn't parse as I'd like it. The hope is to create categories that group items together. Their value is sent to a template and the grouping/categories are done by the template.

The categories seem to be evaluated before winter gets to them, however. In the above example, all items are put in that category.

This: 

Adds either or  to the text of the article - it is not turned into a link or category note.

I've tried some other variations (using #if to add/remove statements, for instance), but haven't had luck. It just seems every way I try the category check is done before Winter is run. I was hoping there was some way or another I could fool the system, but no luck so far. Is there any way this can be done with Winter (or some other tool you know off hand, if Winter runs too late in the process)?
 * I'm not sure if this is possible unfortunately --Frantik 22:35, 11 August 2006 (UTC)

Question on variable scoping
I couldn't find any description of variable scoping. Can I reference a varaiable defined outside of a function inside the function? For example:

foo= rate=

Gives me: foo= rate=20


 * Variables are always local, never global. If you define one outside a function, you cannot use it inside the function, and vice-verse
 * --Frantik 10:58, 17 December 2006 (UTC)

"Call-time pass-by-reference"
I just installed Winter 2.0.1 on MediaWiki 1.10.0 with PHP 5.2.2. I did nothing other than place Winter.php in the extensions directory and add 'require_once("extensions/Winter.php");' to the bottom of LocalSettings.php (similar to many other extensions I have installed). I started getting the error following error on all pages on my site immeditely after installing Winter:

Warning: Call-time pass-by-reference has been deprecated; If you would like to pass it by reference, modify the declaration of call_user_func. If you would like to enable call-time pass-by-reference, you can set allow_call_time_pass_reference to true in your INI file. in /..../extensions/Winter.php on line 1658

I'm very new to PHP but the documentation on my web host's site seems to incdicate that I can change this setting (allow_call_time_pass_reference) but am advised not to (ie to change the offending PHP instead). Did I install something wrong? Does this PHP setting normally have to be changed when using Winter? Is this indicative of some other problem? Possibly a conflict with another extension I have installed already?

Any help would be greatly appreciated!

Graham. 70.18.28.113 06:02, 12 August 2007 (UTC)
 * Hi Graham,


 * I’ve solved the issue, which I missed because allow_call_time_pass_reference is enabled by default. However it is disabled in the "recommended" setup.  I will release another version shortly. In the meantime you can change these lines to solve the problem:

Line 1643: $ret = call_user_func($functionString[1],&$arr); to $ret = $functionString[1]($arr);

Line 1658 $ret = call_user_func($functionString[1],&$arr, $flag); to $ret = $functionString[1]($arr, $flag);
 * --Frantik 09:58, 12 August 2007 (UTC)

This issue has been resolved in Winter 2.0.2 --Frantik 13:25, 12 August 2007 (UTC)

Hi - I just tried the workaround and the update (2.0.2) - both appear to work just as advertized. Thanks much for the quick fix! - Graham 70.18.28.113 03:47, 13 August 2007 (UTC)

Winter breaking when embedded into another template
I've come across a problem with Winter that I cannot solve. (Using Winter 2.1.0 on MediaWiki 1.10)

I have a URL_Rewrite template which looks something like this:



The intent is that someone can pass a Java path in the form .com.some.path.object to this template and get back an HTTP link formed from the Java path (where the dots are replaced by slashes and the first part of the URL is added). This works fine in the regular text. It fails though with nested templates.

I have a Note template which is built like this:

This basically creates a 2 cell table with a colored background, puts an icon in the first cell and the text passed as a variable into the second cell.

If the text passed to this Note template includes a template call to the URL_Rewrite template, then the URL_Rewrite template breaks - ie the Winter parsing is not done. The text in the Note template leading up to where the URL_Rewrite template is called is dropped, and bits of the URL_Rewrite template is shown. Example:

Template call

Result

.|/|com.some.path.Object}}.html com.some.path.Object] the rest of the text passed to the Note template

If there is more than one call to the URL_Rewrite template in the text passed to the Note template, then after the first broken rendering of the URL_Rewrite, all following URL_Rewrite instances work perfectly.

I am not sure how to go about solving this one. Any tips or suggestions? --Cdc 09:10, 5 October 2007 (UTC)

A little investigation reveals the problem is directly linked to the fact that the Note template uses a table. If I remove the table markup then all URL_Rewrite template calls passed to the Note template work perfectly. So, the problem is something to do with how Winter and MediaWiki are handling the table. --Cdc 10:19, 5 October 2007 (UTC)