Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

...

null button(string $title, string $route)

Creates the an action button for your section. Usually used when you want a user to add an item.

Image Removed

 

Info
titleNotice

This function requires setting the section name beforehand by using the section() function.

Parameters

$name

Title for your button.

$route

URL route to the page.

Examples

...

languagephp

...

block(int $callback_id, Closure $callback)

...

Requires: phpFox 4.3+

Connects a block in specific locations and routes based on the JSON Configuration assignment for blocks.

Parameters

...

$callback_id

Block location number.

$callback

Callback function that will be executed when the block is to be loaded.

Examples

...

Assigning blocks in your app.json file. 

Code Block
{
   "id": "Sample",
   "name": "My Sample App",
   "version": 1,
   "icon": "",
   "blocks": [
      {
         "callback": "sample_block",
         "route": "route_v",
         "location": 3
      },
      {
         "callback": "sample_block_with_view",
         "route": "core.index-member",
         "location": 3
      }
   ]
}

 

Connect block assignments in your start.php 

Code Block
<?php

/**
 * Adds a block and assigns it to "sample_block"
 */
block('sample_block', function() {
   $html = '<div class="block"><div class="title">Hello World!</div><div class="content">...</div></div>';
Must
set the section firstreturn $html;
});

section('Foo',
'/foo');/**
 * Adds a //block Create an action menu
   button('Create', '/foo/bar');
and assigns it to "sample_block_with_view" with an HTML view
 */
block('sample_block_with_view', function() {

   return view('index@Sample/block.html');
});

 

!Important: Make sure to clear your sites cache after assigning a block.

Notes

...

Since 4.3+

Blocks are not required to be included in a route and is no longer the advised way to create a block. While old methods are still supported in 4.3, they will be depreciated in the future. The change in how blocks work in 4.3 is to give clients the ability to re-position your blocks from the AdminCP.

 

HTML Views

If you use an HTML view via the view() function you must prefix the HTML with your apps ID (e.g. @Sample/)

 

Identifying Route Names

 Finding the name of a route can be hard at times, enable Techie Mode to make things easier.