Some further info...

Firstly, apologies for the typo in the page name; I of course meant: \themes\blackcandy\templates\layout\Page.ss

Now, if I amend the code slightly to this:

      <h2>$Title</h2>
      $Content
      $Form
      $PageComments
      $Trombinoscope(Any old value)

and this:

   function Trombinoscope($myValue) {
      include('myPath\myFile.php');
      return $myValue;
   }

the string "Any old value" appears in the correct place on the page, ie. after the PageComments, yet the 'included' file (myPath\myFile.php) still appears before the <!DOCTYPE declaration.

So I'm assuming I need to 'do something else', possibly with the return value of the function, but can't figure out what.

All comments appreciated,

Hi
You can't just include a php file and then assume it will output it's content where you want. AFAIK, your "Trombinoscope" function is called by the SSViewer when it populates the template. Since your script most likely uses echo, the output will be sent to the browser at the time of the function call. I guess, the function calls occur before the whole template data is being assembled. Thus, the content appears at top of the page.

The $Trombinoscope variable in the template will be filled with the return value of the corresponding function, which is in your case: nothing, or as you noticed, the contents of $myValue.

There might be a solution to this though. PHP allows you to capture all output using the "Output control functions" (http://ch.php.net/manual/en/ref.outcontrol.php). I suggest, you try something like this:

This will capture all output from myFile.php to the $data variable. The function then returns the captured data which is exactly what the template engine needs.