Creating a page?

[Michael]

Is there any documentation on how to create a page? Thank you.

 

[Paul B]

thanks Brogan, but how do you get a new page under the "Help"-tree ?

You need to edit the help_index template for that.

 

[Peggy]

ummmm...ok

 

[Kier]

For more information about how to use PHP in pages, see the latest Have You Seen... videos:

Editing Templates and Defining a Callback for Pages

 

[Xarcell]

As you might expect that will not work.

Ok, into the the Template HTML-field you write:

<div class="baseHtml messageText">

{xen:raw $myContent}

</div>

You have to set a PHP callback class and method

class-name: XenForo_Pages_Test

method-name: includeFile

When naming the class you should keep the xenforo folder structure in mind.

Now you have to create a php-file <xenforo>/library/XenForo/Pages/Test.php. The sub-folder Pages does not exists by default, so you have to create it first. The file/path and the clase-name must match or you will end up in an error.

The php-file content:

<?php
class XenForo_Pages_Test
{
     public static function includeFile(XenForo_ControllerPublic_Abstract  $controller, XenForo_ControllerResponse_Abstract &$response)
    {
        ob_start();
        require('/path/to/your/html/file.html');
        $myContent = ob_get_contents();
        ob_end_clean();

        $params = array(
            'myContent'  => $myContent
        );

        $response->params = array_merge(
            $response->params,
            $params
        );
    }
}

That example is quite simple, you can easily assign more variables to the $params-array or include php-files with even more vars. :-D

Edit: Added <?php to the code example.

I'm trying to include a single php file(page-pickup-lines.php) into a forum page. I tried following your method, but get an error when I try to view the for page:
Fatal error: XenForo_Pages_PickupLines::includeFile() [function.require]: Failed opening required '/home/xarcell/public_html/xxxxxx.com/page-pickup-lines.php' (include_path='/home/xarcell/public_html/xxxxxx.com/library:.') in /home/xarcell/public_html/xxxxxx.com/library/XenForo/Pages/PickupLines.php on line 19

Here's what I did...

Created PickupLines.php and uploaded to library/Xenforo/Pages with the following content:

<?php
class XenForo_Pages_PickupLines
{
     public static function includeFile(XenForo_ControllerPublic_Abstract  $controller, XenForo_ControllerResponse_Abstract &$response)
    {
        ob_start();
        require('/home/xarcell/public_html/inspireromance.com/page-pickup-lines.php');
        $pickupLines = ob_get_contents();
        ob_end_clean();

        $params = array(
            'pickupLines'  => $pickupLines
        );

        $response->params = array_merge(
            $response->params,
            $params
        );
    }
}

Then I created a forum page with this as the HTML:

<div class="baseHtml messageText">

{xen:raw $pickupLines}

</div>

Callback: "XenForo_Pages_PickupLines :: includeFile"

What did I do wrong?

My php file that I'm trying to include contains this:

<?php

echo '<div>hello world</div>';

?>

 

[Xarcell]

NVM, I got it. I changed require to include, and made sure my path was correct.

 

[Xarcell]

Now I have another problem. I am unable to apply any classes or add CSS to the php file. What is the proper way of doing that?

 

[Jake Bunce]

Now I have another problem. I am unable to apply any classes or add CSS to the php file. What is the proper way of doing that?

CSS classes are referenced in your HTML code. For example:

<?php

echo '<div class="secondaryContent">hello world</div>';

?>

You can make use of xenForo CSS classes in your HTML because it will be output within a xenForo page node.

 

[Xarcell]

I'll have to play with it a bit more then, because I couldn't get it to work.

 

[Michael]

I am getting this when submitting a form, it seems to pull the php fine until I submit the form thats in the included file:

Security error occurred. Please press back, refresh the page, and try again.

Any ideas on how I could fix it?

Thanks

 

[Paul B]

That could be related to an incorrect security token.

 

[ragtek]

yes, add the _xfToken to your form

 

[Michael]

Could you tell me where that would go please?

I tried this but it didnt work:

    <form method="post" name="_xfToken" value="{$visitor.csrf_token_page}">

and I then removed that and added this below the submit input:

    <input type="hidden" name="_xfToken" value="{$visitor.csrf_token_page}" />

Not really sure where these should be or if theyre correct.

 

[ragtek]

It should be

<input type="hidden" name="_xfToken" value="{$visitor.csrf_token_page}" />

and doesn't care where you place it, it just have to be in the form
for example before the closing tag


<input type="hidden" name="_xfToken" value="{$visitor.csrf_token_page}" />
</form>

 

[CFodder]

Is there any way of getting it to populate the latest post box on the forumhome?

 

[Michael]

It should be

<input type="hidden" name="_xfToken" value="{$visitor.csrf_token_page}" />

and doesn't care where you place it, it just have to be in the form
for example before the closing tag


<input type="hidden" name="_xfToken" value="{$visitor.csrf_token_page}" />
</form>

Thanks, now I get this on submit:

A server error occurred. Please try again later.

Any ideas how to fix that?

 

[Lqd]

Here's what I did...

Created PickupLines.php and uploaded to library/Xenforo/Pages with the following content:

<?php
class XenForo_Pages_PickupLines
{
    public static function includeFile(XenForo_ControllerPublic_Abstract  $controller, XenForo_ControllerResponse_Abstract &$response)
    {
        ob_start();
        include('/home/xarcell/public_html/inspireromance.com/page-pickup-lines.php');
        $pickupLines = ob_get_contents();
        ob_end_clean();

        $params = array(
            'pickupLines'  => $pickupLines
        );

        $response->params = array_merge(
            $response->params,
            $params
        );
    }
}

Then I created a forum page with this as the HTML:

<div class="baseHtml messageText">

{xen:raw $pickupLines}

</div>

Callback: "XenForo_Pages_PickupLines :: includeFile"

My php file that I'm trying to include contains this:

<?php

echo '<div>hello world</div>';

?>

So what if I want to include $pickupLines in an other template? How would I approach this? simply placing: {xen:raw $pickupLines} somewhere doesnt seem to do the trick....

 

[Umit]

So what if I want to include $pickupLines in an other template? How would I approach this? simply placing: {xen:raw $pickupLines} somewhere doesnt seem to do the trick....

Yes, i'd like to do the same, include it into templates but adding {xen:raw $pickupLines} is not working. Please help.

 

[MikeMpls]

NVM, I got it. I changed require to include, and made sure my path was correct.

Same for me: "include" works, "require" doesn't. In my case the path name also has to be relative to the directory to which the domain maps:

include('library/XenForo/Pages/TestHi.php');

 

[bubbl3]

Thanks so much for this, i was able to include a java irc applet that gets parameters from xenforo db, just awesome

 

[Thronk]

A little old post I know, but everything I search for including a PHP file in xenforo is outdated, if that matters or not.
Anyways, I've followed the instructions here and after some trial and error I finally got the page showing without errors (mostly due to file paths that I overlooked), but, it's not showing the contents of the php file it's pointing to. Which is located at /donate/donate.php.


The main content PHP file is a donation script that requires other PHP files for mysql connection and config.
The include file path is the absolute path to the donate.php so I know it's pointing to it.
Callback is XenForo_Pages_Test :: includeFile

All that's showing is the title "Donations" then the footer.

I'm tired and probably overlooking something, but thought I'd post and see if someone can help me somehow by tomorrow.