WicketStuff

https://github.com/wicketstuff/core
Admin
WicketStuff is a collection of open source projects and extensions for the Apache Wicket web...
Tokens:105,269
Snippets:1,310
Trust Score:8
Update:6 months ago
Show doc for...
Tokens:
Raw
### Run Examples via Maven

Source: https://github.com/wicketstuff/core/blob/master/openlayers3-parent/README.md

Navigate to the examples directory and launch the application using Jetty.

```bash
cd jdk-1.6-parent/openlayers3-parent/openlayers3-examples/
mvn jetty:run
```

--------------------------------

### Wicket Push Usage Example

Source: https://github.com/wicketstuff/core/wiki/projects/Push

Example demonstrating the general usage pattern of wicket-push, including setting up an IPushEventHandler, obtaining an IPushService, installing a push node, and forwarding events from a background service.

```java
/*
 * panel constructor
 */
public ChatPanel()
{
    // setup UI components ...

    /*
     * 1. instantiate push event handler
     */
    IPushEventHandler handler = new AbstractPushEventHandler<Message>()
    {
        public void onEvent(AjaxRequestTarget target, Message message, IPushNode<Message> node, IPushEventContext<Message> ctx)
	{
                // TODO your component update logic goes here...
	}
    });

    /*
     * 2. obtain a reference to a Push service implementation
     */
    IPushService pushService = TimerPushService.get();

    /*
     * 3. install push node into this panel
     */
    IPushNode<Message> pushNode = pushService.installNode(this, handler);

    /*
     * 4. connect to the chat service and forward the Message events to the push node and it's event handler
     */
    IChatService chatService = ServiceLocator.getChatService();
    chatService.addListener(new IChatListener() {
        public void onMessage(Message msg)
        {
            if (pushService.isConnected(pushNode))
                // forward the Message event via the push service to the push event handler
                pushService.publish(pushNode, msg);
            else
                chatService.removeListener(this);
        }
    });
}
```

--------------------------------

### Run Demo Application

Source: https://github.com/wicketstuff/core/blob/master/dashboard-parent/README.md

Commands to install and run the demo application using Maven and Jetty.

```bash
mvn install
cd demo
mvn jetty:run
```

--------------------------------

### Build the Project with Maven

Source: https://github.com/wicketstuff/core/blob/master/wicket-security-parent/README.md

Use this Maven command to clean and install the project dependencies and build the project.

```bash
mvn clean install
```

--------------------------------

### Installation

Source: https://github.com/wicketstuff/core/blob/master/select2-parent/README.md

Instructions on how to add the Wicketstuff Select2 dependency to your Maven project.

```APIDOC
## Installation

### Description
Add the Wicketstuff Select2 dependency to your project's pom.xml file.

### Method
Maven Dependency

### Endpoint
N/A

### Parameters
N/A

### Request Example
```xml
<dependency>
    <groupId>org.wicketstuff</groupId>
    <artifactId>wicketstuff-select2</artifactId>
	<version>...</version>
</dependency>
```

### Response
N/A
```

--------------------------------

### Apply Security and Mount Annotations to Pages

Source: https://github.com/wicketstuff/core/wiki/Servlet-Container-Authentication-and-Authorization

Examples of applying @MountPath and @AuthorizeInstantiation at the class and package levels.

```java
@MountPath("index.html")
public class HomePage extends BasePage

@MountPath("secure/admin/admin.html")
@AuthorizeInstantiation({"tomcat", "admin"})
public class AdminPage extends BasePage

/** This is in package-info.java **/
@AuthorizeInstantiation({"tomcat", "role1", "admin"}) 
package org.wicketstuff.servlet3.secure.example.ui.pkgExample;

/** This a class in the same package */
package org.wicketstuff.servlet3.secure.example.ui.pkgExample;
public class Page3 extends BasePage
{

@AuthorizeInstantiation({"tomcat", "role1", "admin"})
public class Page2 extends BasePage
```

--------------------------------

### Basic SwarmWebApplication Extension

Source: https://github.com/wicketstuff/core/wiki/Wicket-Security---3.-Getting-started

Extend SwarmWebApplication to handle core security setup. You must implement getHiveKey, setUpHive, getHomePage, and getLoginPage.

```java
package org.apache.wicket.security.examples.multilogin;

public class MyApplication extends SwarmWebApplication {
    public MyApplication() {
    }

    @Override
    protected Object getHiveKey() {
        // TODO Auto-generated method stub
        return null;
    }

    @Override
    protected void setUpHive() {
        // TODO Auto-generated method stub
    }

    @Override
    public Class getHomePage() {
        // TODO Auto-generated method stub
        return null;
    }

    @Override
    public Class getLoginPage() {
        // TODO Auto-generated method stub
        return null;
    }
}
```

--------------------------------

### Component Permission Example

Source: https://github.com/wicketstuff/core/wiki/Wicket-Security---3.-Getting-started

An example of a permission grant within a hive policy file, specifying component access rights.

```java
grant
{
    permission org.apache.wicket.security.hive.authorization.permissions.ComponentPermission "org.apache.wicket.security.examples.multilogin.pages.HomePage", "inherit, render";

```

--------------------------------

### Various @Context Injection Examples

Source: https://github.com/wicketstuff/core/wiki/projects/Context

Provides examples of injecting different types of objects using the @Context annotation, including components, interfaces, collections, models, and qualified instances.

```java
@Context Component component;
@Context SomeInterface componentThatImplementsTheInterface;
@Context Set<Component> setOfComponents;
@Context List<Component> listOfComponents;
@Context Set<SomeInterface> setOfComponents;
@Context List<SomeInterface> setOfComponents;
@Context(qualifier="imp") Set<Label> impLabels;

@Context IModel<Data> model;
@Context Data data;

// all above can be combined with the `Instance`:

@Context Instance<Component> component;
@Context Instance<IModel<Data>> data;
```

--------------------------------

### Add New Row in QuickGridView

Source: https://github.com/wicketstuff/core/wiki/quickview

Shows the setup for a QuickGridView component, which renders items in a table or grid format with support for partial AJAX updates.

```java
Component start=new EmptyPanel("start");      
        Component end =new EmptyPanel("end");
        IDataProvider<Integer> data = new ListDataProvider<Integer>(list);
        WebMarkupContainer numbers = new WebMarkupContainer("numbers");   //parent for quickview
        numbers.setOutputMarkupId(true);  //needed for ajax
        final QuickGridView<Integer> number=new QuickGridView<Integer>("number",data,start,end) {   
            @Override
            protected void populate(CellItem<Integer> item) {
                item.add(new Label("display", item.getModel()));
            }

            @Override
            protected void populateEmptyItem(CellItem<Integer> item) {
                item.add(new Label("display"));
            }
        };
        number.setColumns(2);
        numbers.add(number);
        add(numbers);

        AjaxLink addLink = new AjaxLink("addLink") {

            @Override
            public void onClick(AjaxRequestTarget target) {
                int newObject=10,newObject=20;
```

--------------------------------

### Use ReplacingResourceModel

Source: https://github.com/wicketstuff/core/wiki/projects/Minis

Examples showing the implementation of ReplacingResourceModel in Java, HTML, and properties files.

```java
add(new Label("label", new ReplacingResourceModel("key2")));
```

```html
<span wicket:id="label"></span>
```

```properties
key1=value of key1
key2=value of key2 contains ${key1}
```

```text
value of key2 contains value of key1
```

--------------------------------

### Simple JavaScript Execution Example

Source: https://github.com/wicketstuff/core/wiki/NashornIntegration

A basic JavaScript snippet to be posted to the Nashorn resource reference. The script assigns a value to a variable and then returns that variable's value.

```javascript
var x = 3;
x;
```

--------------------------------

### Run Gollum Web Server

Source: https://github.com/wicketstuff/core/wiki/dev/Editing-Wiki-Locally

Start the Gollum web server from the root of your cloned wiki repository. This command runs a local webserver on http://127.0.0.1:4567.

```bash
gollum
```

--------------------------------

### Configure Authentication Manager with ProviderManager

Source: https://github.com/wicketstuff/core/wiki/Wicket-Security---4.-Spring-security

Sets up the 'authenticationManager' using 'ProviderManager', delegating to specified 'AuthenticationProvider' beans. This example uses 'testAuthenticationProvider'.

```xml
<!-- Authentication manager, configured with one provider that retrieves authentication information
        from test data. -->
<bean id="authenticationManager" class="org.acegisecurity.providers.ProviderManager">
    <property name="providers">
        <list>
            <ref local="testAuthenticationProvider"/>
        </list>
    </property>
</bean>
```

--------------------------------

### Configure Nashorn Resource Reference in WebApplication

Source: https://github.com/wicketstuff/core/wiki/NashornIntegration

Sets up the Nashorn module within a Wicket WebApplication. Configure thread pool size, maximum run duration, memory check interval, and allowed memory. The setup method allows binding objects to the script's scope and defining writers for output and errors. Debug mode outputs AST information.

```java
public class NashornApplication extends WebApplication
{

	private static NashornObject nashornObject = new NashornObject();

	@Override
	public Class<? extends Page> getHomePage()
	{
		return NashornPage.class;
	}

	@Override
	protected void init()
	{
		// Initial thread pool of 10 concurrent scripts
		// Maximum run duration 5 Seconds
		// Memory check interval 10 seconds (optional)
		// Allowed memory 31457280 => 30mb (optional, but requires check interval)
		mountResource("/nashorn", new NashornResourceReference("nashorn", 10, 5, TimeUnit.SECONDS,
			10, TimeUnit.MILLISECONDS, 31457280)
		{

			private static final long serialVersionUID = 1L;

			@Override
			protected void setup(Attributes attributes, Bindings bindings)
			{
				// which objects are going to be accessable
				bindings.put("nashornObject", nashornObject); 
			}

			@Override
			protected Writer getWriter()
			{
				// Where to write output
				return new BufferedWriter(new OutputStreamWriter(System.out)); 
			}

			@Override
			protected Writer getErrorWriter()
			{
				// Where to write errors
				return new BufferedWriter(new OutputStreamWriter(System.out));
			}

			@Override
			protected boolean isDebug()
			{
				// Outputs AST information and other stuff while executing the actual script
				return true;
			}

			@Override
			protected ClassFilter getClassFilter()
			{
				// default is to allow nothing!
				return new ClassFilter()
				{
					@Override
					public boolean exposeToScripts(String name)
					{
						// which classes are allowed to be accessed (name is full qualified)
						return false; 
					}
				};
			}

		});
	}
}
```

--------------------------------

### Clone Wicketstuff Core Wiki

Source: https://github.com/wicketstuff/core/wiki/dev/Editing-Wiki-Locally

Use this command to clone the Wicketstuff Core wiki repository locally. Ensure you have Git installed and the correct writable Git location.

```bash
git clone git@github.com:wicketstuff/core.wiki.git
```

--------------------------------

### Build and Run Wicket-Foundation Sample

Source: https://github.com/wicketstuff/core/blob/master/wicket-foundation/README.md

Use these Maven commands to build the project and run the sample application using Jetty. Navigate to http://localhost:8080 in your browser to view the sample.

```bash
mvn clean install
cd wicket-foundation-samples
mvn jetty:run
```

--------------------------------

### Handle GET Form Submission

Source: https://github.com/wicketstuff/core/wiki/JEE-Web-Integration

Retrieve parameters from a GET request in a Wicket page.

```java
public TestPage2(PageParameters parameters){
	String hiddenparam = parameters.get("hiddenparam").toString();
}
```

--------------------------------

### Install Gollum Wiki Engine

Source: https://github.com/wicketstuff/core/wiki/dev/Editing-Wiki-Locally

Install the Gollum wiki engine using RubyGems. Markdown support is also required.

```bash
gem install gollum
```

```bash
gem install rdiscount
```

--------------------------------

### Basic Event Handler Example

Source: https://github.com/wicketstuff/core/blob/master/annotationeventdispatcher-parent/README.md

A basic example of an event handler method annotated with `@OnEvent`. This method will be invoked when an event of the specified type is broadcast.

```java
@OnEvent public void handleSavePersonEvent(SaveEvent<Person> event) { ... }
```

--------------------------------

### Implement Basic Foundation Tooltip

Source: https://github.com/wicketstuff/core/blob/master/wicket-foundation/wicket-foundation-samples/src/main/java/org/wicketstuff/foundation/TooltipsPage.html

Create a simple tooltip using the FoundationTooltipBehavior with default settings.

```html
<span wicket:id="basic"></span>
```

```java
Label basic = new Label("basic", Model.of("Hover on desktop or touch me on mobile!"));
basic.add(new FoundationTooltipBehavior("Tooltips are awesome, you should totally use them!"));
add(basic);
```

--------------------------------

### Initialize AjaxItemsNavigator

Source: https://github.com/wicketstuff/core/wiki/quickview

Instantiate AjaxItemsNavigator with a navigator ID and a QuickView instance. Add it to the page.

```java
AjaxItemsNavigator navigator=new AjaxItemsNavigator("navigator",quickView);
add(navigator) ;
```

--------------------------------

### Access Spring Beans via SpringReference get()

Source: https://github.com/wicketstuff/core/wiki/projects/SpringReference

Access the injected Spring beans using the get() method of the SpringReference objects. This retrieves the actual bean instance managed by Spring.

```java
authenticationManagerRef.get().authenticate(token);
AbstractRememberMeServices rememberMeServices = rememberMeServicesRef.get();
```

--------------------------------

### Initialize Partition Layout

Source: https://github.com/wicketstuff/core/blob/master/serializer-common/src/main/java/org/wicketstuff/pageserializer/common/analyze/report/d3js/d3js-partition-template.html

JavaScript implementation for rendering the D3 partition layout and handling click-to-zoom interactions.

```javascript
var w = 1120, h = 600, x = d3.scale.linear().range([0, w]), y = d3.scale.linear().range([0, h]); var vis = d3.select("#body").append("div") .attr("class", "chart") .style("width", w + "px") .style("height", h + "px") .append("svg:svg") .attr("width", w) .attr("height", h); var partition = d3.layout.partition() .value(function(d) { return d.size; }); var data = ${DATA}; //d3.json("flare.json", function(data) { node = root = data; var g = vis.selectAll("g") .data(partition.nodes(root)) .enter().append("svg:g") .attr("transform", function(d) { return "translate(" + x(d.y) + "," + y(d.x) + ")"; }) .on("click", click); var kx = w / root.dx, ky = h / 1; g.append("svg:rect") .attr("width", root.dy * kx) .attr("height", function(d) { return d.dx * ky; }) .attr("class", function(d) { return d.children ? "parent" : "child"; }); g.append("svg:text") .attr("transform", transform) .attr("dy", ".35em") .style("opacity", function(d) { return d.dx * ky > 12 ? 1 : 0; }) .text(function(d) { return d.name; }) d3.select(window) .on("click", function() { click(root); }) function click(d) { if (!d.children) return; kx = (d.y ? w - 40 : w) / (1 - d.y); ky = h / d.dx; x.domain([d.y, 1]).range([d.y ? 40 : 0, w]); y.domain([d.x, d.x + d.dx]); var t = g.transition() .duration(d3.event.altKey ? 7500 : 750) .attr("transform", function(d) { return "translate(" + x(d.y) + "," + y(d.x) + ")"; }); t.select("rect") .attr("width", d.dy * kx) .attr("height", function(d) { return d.dx * ky; }); t.select("text") .attr("transform", transform) .style("opacity", function(d) { return d.dx * ky > 12 ? 1 : 0; }); d3.event.stopPropagation(); } function transform(d) { return "translate(8," + d.dx * ky / 2 + ")"; } //}); function size(d) { return d.size; } function count(d) { return 1; } function zoom(d) { var kx = w / d.dx, ky = h / d.dy; x.domain([d.x, d.x + d.dx]); y.domain([d.y, d.y + d.dy]); var t = svg.selectAll("g.cell").transition() .duration(d3.event.altKey ? 7500 : 750) .attr("transform", function(d) { return "translate(" + x(d.x) + "," + y(d.y) + ")"; }); t.select("rect") .attr("width", function(d) { return kx * d.dx - 1; }) .attr("height", function(d) { return ky * d.dy - 1; }) t.select("text") .attr("x", function(d) { return kx * d.dx / 2; }) .attr("y", function(d) { return ky * d.dy / 2; }) .style("opacity", function(d) { return kx * d.dx > d.w ? 1 : 0; }); node = d; d3.event.stopPropagation(); }
```

--------------------------------

### Apply LinkifyBehavior

Source: https://github.com/wicketstuff/core/wiki/Twitter

Automatically links Twitter handles starting with @ within a component.

```java
		final Label label = new Label("label", "This is a linkify test by @tfreier");
		label.add(new LinkifyBehavior("your api key"));

		add(label);
```

```html
		<span wicket:id="label"></span>
```

--------------------------------

### QuickView with AjaxPagingNavigator

Source: https://github.com/wicketstuff/core/wiki/quickview

Configure QuickView with a data provider and items per request. Add it to a WebMarkupContainer and attach an AjaxPagingNavigator.

```java
IDataProvider<Integer> data=new ListDataProvider<Integer>(list);
        final int itemsPerRequest=4;//rows created per request
        // quickview by default works fine for paging 
        QuickView<Integer> quickView=new QuickView<Integer>("number",data,itemsPerRequest) {
            @Override
            protected void populate(Item<Integer> item) {
                item.add(new Label("display",item.getModel()));
            }
        } ;
       //don't forget adding quickview to parent with any ajax navigator
        WebMarkupContainer numbers=new WebMarkupContainer("numbers");   
        numbers.add(quickView);
        numbers.setOutputMarkupId(true); //don't forget required when using ajax navigators
        add(numbers);
        AjaxPagingNavigator navigator=new AjaxPagingNavigator("navigator",quickView);
        add(navigator) ;
```

--------------------------------

### Initialize AjaxItemsNavigator with QuickGridView

Source: https://github.com/wicketstuff/core/wiki/quickview

Instantiate AjaxItemsNavigator with a navigator ID and a QuickGridView instance. Add it to the page.

```java
AjaxItemsNavigator navigator=new AjaxItemsNavigator("nav",gridView);
add(navigator);
```

--------------------------------

### Sending AbstractTargetedEvent

Source: https://github.com/wicketstuff/core/blob/master/annotationeventdispatcher-parent/README.md

Example of sending an event that carries an AjaxRequestTarget, useful for AJAX updates.

```java
send(this, Broadcast.BUBBLE, new CancelEvent(target));
```

--------------------------------

### Configured SwarmWebApplication

Source: https://github.com/wicketstuff/core/wiki/Wicket-Security---3.-Getting-started

A more detailed implementation of SwarmWebApplication, showing how to configure the hive key, set up the hive with a policy file, and specify home and login pages.

```java
package org.apache.wicket.security.examples.multilogin;

public class MyApplication extends SwarmWebApplication {
    @Override
    protected Object getHiveKey() {
        //if you are using servlet api 2.5 I would suggest using:
        //return getServletContext().getContextPath();

        //if not you have several options:
        //-an initparam in web.xml
        //-a static object
        //-a random object
        //-whatever you can think of

        //for this example we will be using a fixed string
        return "multi-login";
    }

    @Override
    protected void setUpHive() {
        //create factory
        // For 1.4 use new SwarmPolicyFileHiveFactory(getActionFactory());
        PolicyFileHiveFactory factory = new PolicyFileHiveFactory();

        try {
            //this example uses 1 policy file but you can add as many as you like
            factory.addPolicyFile(getServletContext().getResource("/WEB-INF/multilogin.hive"));
        }
        catch (MalformedURLException e) {
            throw new WicketRuntimeException(e);
        }
        //register factory
        HiveMind.registerHive(getHiveKey(), factory);
        //note we are not checking if a hive already exist because this app will only be deployed once
    }

    @Override
    public Class getHomePage() {
        return HomePage.class;
    }

    @Override
    public Class getLoginPage() {
        return LoginPage.class;
    }
}
```

--------------------------------

### Log Message in Wicket Component

Source: https://github.com/wicketstuff/core/wiki/projects/Logback

Example of logging a message from within a Wicket WebPage.

```java
public class HomePage extends WebPage {
	private static final long serialVersionUID = 2696517689763106924L;

	private static final Logger LOGGER = LoggerFactory
			.getLogger(HomePage.class);

	public HomePage() {
		LOGGER.info("Logging is good - said the lumberjack.");
	}
}
```

--------------------------------

### Apply WebVTT classes to HTML

Source: https://github.com/wicketstuff/core/wiki/projects/Html5

Example of applying CSS classes to a WebVTT cue element.

```html
<c.red.background-yellow>Red text with a yellow background.</c>
```

--------------------------------

### Build and Deploy Artifacts

Source: https://github.com/wicketstuff/core/wiki/dev/Wicket-Stuff-Core-Release-Process

Commands to build and deploy release artifacts to the central repository.

```text
MAVEN_OPTS=-Xmx512m mvn -DperformRelease=true -Pdo-publish,central-release [-Dgpg.passphrase=yourGpgPassPhrase] clean deploy
```

```text
MAVEN_OPTS=-Xmx512m mvn -DperformRelease=true [-Dgpg.passphrase=yourGpgPassPhrase] clean deploy

MAVEN_OPTS=-Xmx512m mvn -DperformReleaseGoogleCode=true [-Dgpg.passphrase=yourGpgPassPhrase] clean deploy
```

--------------------------------

### Basic Grid Structure

Source: https://github.com/wicketstuff/core/blob/master/wicket-foundation/wicket-foundation-samples/src/main/java/org/wicketstuff/foundation/IndexPage.html

Demonstrates a twelve-column grid layout using Foundation. Each column includes a `div.panel` for visualization, which is not required for the grid itself.

```html
<h6>This is a twelve column section in a row.</h6>
<div class="row">
  <div class="small-6 columns">
    <div class="panel">
      <h6>Six columns</h6>
    </div>
  </div>
  <div class="small-6 columns">
    <div class="panel">
      <h6>Six columns</h6>
    </div>
  </div>
</div>
<div class="row">
  <div class="small-4 columns">
    <div class="panel">
      <h6>Four columns</h6>
    </div>
  </div>
  <div class="small-4 columns">
    <div class="panel">
      <h6>Four columns</h6>
    </div>
  </div>
  <div class="small-4 columns">
    <div class="panel">
      <h6>Four columns</h6>
    </div>
  </div>
</div>
```

--------------------------------

### Generic SaveEvent Example

Source: https://github.com/wicketstuff/core/blob/master/annotationeventdispatcher-parent/README.md

Shows a generic SaveEvent being sent with different types of payloads (person and widget).

```java
send(this, Broadcast.BUBBLE, new SaveEvent<>(target, person));
send(this, Broadcast.BUBBLE, new SaveEvent<>(target, widget));
```

--------------------------------

### Implement Small Grid Layouts

Source: https://github.com/wicketstuff/core/blob/master/wicket-foundation/wicket-foundation-samples/src/main/java/org/wicketstuff/foundation/GridPage.html

Use small-prefixed classes to define column widths for mobile-first layouts.

```html
<div class="row">
  <div class="small-2 columns">2 columns</div>
  <div class="small-10 columns">10 columns</div>
</div>
<div class="row">
  <div class="small-3 columns">3 columns</div>
  <div class="small-9 columns">9 columns</div>
</div>
```

--------------------------------

### Define Maven Dependency

Source: https://github.com/wicketstuff/core/wiki/Home

Example of adding a WicketStuff artifact dependency to a project's pom.xml file.

```text
<dependency>
<groupId>org.wicketstuff</groupId>
<artifactId>phonebook</artifactId>
<version>1.4.19</version>
</dependency>
```

--------------------------------

### Configure Maven Settings

Source: https://github.com/wicketstuff/core/wiki/dev/Wicket-Stuff-Core-Release-Process

Add Sonatype credentials to your ~/.m2/settings.xml file for deployment.

```xml
<server>
         <id>central-sonatype-repo</id>
         <username>YourUserName</username>
         <password>yourPasswd</password>
</server>
```

--------------------------------

### Initialize Facebook SDK and Like Button

Source: https://github.com/wicketstuff/core/wiki/Facebook

Add the FacebookSdk component to the page and instantiate a LikeButton component.

```java
public class MySocialPage extends WebPage
{
    public MySocialPage()
    {
         add(new FacebookSdk("fbRoot"));

         final IModel<String> url = Model.of("http://wicketstuff.org");
         add(new LikeButton("likeButton", url));
    }
}
```

```html
...
<!-- The Facebook SDK should be the first component in your markup -->
<body>
    <div id="fb-root" wicket:id="fbRoot"></div>

    <div wicket:id="likeButton"></div>
```

--------------------------------

### Maven Dependency Snippet (Stable)

Source: https://github.com/wicketstuff/core/wiki/dev/Editing-Wiki-Locally

Example of a Maven dependency declaration for a stable version of a project artifact.

```xml
<dependency>
    <groupId>org.wicketstuff</groupId>
    <artifactId>project</artifactId>
    <version>1.4.14</version>
</dependency>
```

--------------------------------

### Style for Date Table Headers

Source: https://github.com/wicketstuff/core/blob/master/wicketstuff-datetime-yui-parent/wicketstuff-datetime-yui/src/test/java/org/apache/wicket/extensions/yui/calendar/DatesPage1_ExpectedResult.html

Applies a grey color to table header elements within the Wicket Dates example.

```css
th { color: grey; }
```

--------------------------------

### Instantiate and Show a Modal Form

Source: https://github.com/wicketstuff/core/blob/master/modalx-parent/modalx/gettingstarted.txt

Create an instance of your custom modal form and display it. Ensure your form class extends ModalFormPanel and is associated with an HTML file.

```java
MyForm myForm = new MyForm(allocateWindow(), null);
myForm.show(target);
```

--------------------------------

### Acegi Authentication Manager Configuration

Source: https://github.com/wicketstuff/core/wiki/Wicket-Security---4.-Spring-security

Configures Acegi's authentication manager with a list of providers. This example uses a TestingAuthenticationProvider.

```xml
<bean id="authenticationManager" class="org.acegisecurity.providers.ProviderManager">
			<property name="providers">
				<list>
					<ref local="testAuthenticationProvider"/>
				</list>
			</property>
		</bean>
```

--------------------------------

### Sample Wicket Page for Serialization

Source: https://github.com/wicketstuff/core/blob/master/serializer-kryo2/README.md

A basic WebPage implementation used to demonstrate the serialization report output.

```java
public class SamplePage extends WebPage
{
	public SamplePage()
	{
		add(new ListView<String>("list", Arrays.asList("A", "B", "C"))
		{
			@Override
			protected void populateItem(ListItem<String> item)
			{
				item.add(new Label("label",item.getModel()));
			}
		});
	}
}
```

--------------------------------

### Initialize Persons Archive Application

Source: https://github.com/wicketstuff/core/blob/master/wicketstuff-restannotations-parent/restannotations-examples/src/main/java/org/wicketstuff/rest/Index.html

Sets up the Knockout view model, binds the UI, and initializes the jQuery dialog for user input.

```javascript
$(document).ready(function() { function AppViewModel() { var self = this; this.people = ko.observableArray([]); this.deletePerson = function(person){ var index = self.people.indexOf(person); $.ajax({ type: "DELETE", contentType: "application/json; charset=utf-8", url: "./personsmanager/persons/" + index, async: false }); loadAllPersons(); }; }; var model = new AppViewModel(); ko.applyBindings(model); $( "#dialog-form" ).dialog({ autoOpen: false, height: 200, width: 330, modal: true, buttons: { "Create a person": function(){ var personPojo = new Object(); personPojo.name = $('#name').val(); personPojo.email = $('#email').val(); personPojo.password = $('#password').val(); var modalWindow = $(this); $.ajax({ type: "POST", contentType: "application/json", url: "./personsmanager/persons", data: JSON.stringify(personPojo), async: false, error: function(data){ var dataJson = $.parseJSON(data.responseText); alert(dataJson.message); }, success: function(data){ modalWindow.find('input').val(''); modalWindow.dialog( "close" ); } }); loadAllPersons(); } }, cancel: function() { $( this ).dialog( "close" ); }, }); $('#openNewUser').click(function(event){ $( "#dialog-form" ).dialog( "open" ); }); loadAllPersons(); function loadAllPersons(){ $.ajax({ type: "GET", contentType: "application/json;charset=utf-8", url: "./personsmanager/persons", async: false, success: function(data){ var people = model.people; people.removeAll(); for(var i = 0; i < data.length; i++) people.push(data[i]); } }); } })
```

--------------------------------

### Registering Custom Actions in ActionFactory

Source: https://github.com/wicketstuff/core/wiki/Wicket-Security---3.-Getting-started

Extends SwarmActionFactory to register custom actions. This example shows how to register 'department' action.

```java
public class MyActionFactory extends SwarmActionFactory {
    public MyActionFactory() {
        super();
        try
        {
            // note none of the actions registered this way will 
            // implement the interface defined here, you will 
            // simply get the default action
            register(Department.class,"department");

            // registering an action this way will return the 

```

--------------------------------

### Implement Eidogo Component in Java

Source: https://github.com/wicketstuff/core/wiki/projects/Eidogo

Instantiate the Eidogo component and configure its display settings before adding it to the page.

```java
	// Add an example of eidogo player.
	Eidogo eidogo = new Eidogo("eidogo", "/sgf/example.sgf");
	eidogo.setShowComments(true);
	eidogo.setShowGameInfo(true);
	eidogo.setShowOtions(true);
	eidogo.setShowPlayerInfo(true);
	eidogo.setShowTools(true);
	add(eidogo);
```

--------------------------------

### Add New Row in QuickView

Source: https://github.com/wicketstuff/core/wiki/quickview

Demonstrates initializing a QuickView component and adding items dynamically via AJAX without re-rendering the parent container.

```java
/*
      start and end are boundaries that are used to determine start and end of
       quickview in markup
      the boundaries concept is added new and will be available in 6.14.0
      */
       Component start=new EmptyPanel("start");      
        Component end =new EmptyPanel("end");
        IDataProvider<Integer> data = new ListDataProvider<Integer>(list);
        WebMarkupContainer numbers = new WebMarkupContainer("numbers");   //quickview's parent
        numbers.setOutputMarkupId(true);  //needed for ajax
        final QuickView<Integer> number= new QuickView<Integer>("number",data,start,end)
        {
            @Override
            protected void populate(Item<Integer> item) {
                item.add(new Label("display", item.getModel()));
            }
        };
        numbers.add(number);
        add(numbers);

        AjaxLink addLink = new AjaxLink("addLink") {
            @Override
            public void onClick(AjaxRequestTarget target) {
                int newObject=list.get(list.size()-1) +1;
                list.add( newObject);
               //just enough to create and add a new item in the end
                number.addNewItems(newObject);  
                 }
        };
               add(addLink);
```

--------------------------------

### Maven Dependency Snippet (Development)

Source: https://github.com/wicketstuff/core/wiki/dev/Editing-Wiki-Locally

Example of a Maven dependency declaration for a development snapshot version, including a repository configuration for snapshots.

```xml
<dependency>
    <groupId>org.wicketstuff</groupId>
    <artifactId>project</artifactId>
    <version>1.4-SNAPSHOT</version>
</dependency>

<repository>
	<id>wicketstuff-core-snapshots</id>
	<url>ttps://oss.sonatype.org/content/repositories/snapshots</url>
	<snapshots>
		<enabled>true</enabled>
	</snapshots>		
</repository>
```

--------------------------------

### Create Basic Icon Bar (Java)

Source: https://github.com/wicketstuff/core/blob/master/wicket-foundation/wicket-foundation-samples/src/main/java/org/wicketstuff/foundation/IconBarPage.html

Instantiate an Icon Bar with a list of IconBarItem objects, typically using PackageResourceReference for images.

```java
List<IconBarItem> items = new ArrayList<>();
items.add(new IconBarResourceItem(new PackageResourceReference(this.getClass(), "fi-bookmark.svg"), "Bookmark"));
items.add(new IconBarResourceItem(new PackageResourceReference(this.getClass(), "fi-home.svg"), "Home"));
items.add(new IconBarResourceItem(new PackageResourceReference(this.getClass(), "fi-info.svg"), "Info"));
items.add(new IconBarResourceItem(new PackageResourceReference(this.getClass(), "fi-like.svg"), "Like"));
items.add(new IconBarResourceItem(new PackageResourceReference(this.getClass(), "fi-mail.svg"), "Mail"));
FoundationIconBar iconBar = new FoundationIconBar("basic", items);
add(iconBar);
```

--------------------------------

### D3 Treemap Data Structure Example

Source: https://github.com/wicketstuff/core/blob/master/serializer-common/src/main/java/org/wicketstuff/pageserializer/common/analyze/report/d3js/d3js-zoom-treemap-sample.html

Defines a hierarchical data structure for the treemap, where each node has a name and optionally children and a size attribute.

```json
var data = { "name": "flare", "children": [ { "name": "analytics", "children": [ { "name": "cluster", "children": [ {"name": "AgglomerativeCluster", "size": 3938}, {"name": "CommunityStructure", "size": 3812}, {"name": "HierarchicalCluster", "size": 6714}, {"name": "MergeEdge", "size": 743} ] }, { "name": "graph", "children": [ {"name": "BetweennessCentrality", "size": 3534}, {"name": "LinkDistance", "size": 5731}, {"name": "MaxFlowMinCut", "size": 7840}, {"name": "ShortestPaths", "size": 5914}, {"name": "SpanningTree", "size": 3416} ] }, { "name": "optimization", "children": [ {"name": "AspectRatioBanker", "size": 7074} ] } ] }, { "name": "animate", "children": [ {"name": "Easing", "size": 17010}, {"name": "FunctionSequence", "size": 5842}, { "name": "interpolate", "children": [ {"name": "ArrayInterpolator", "size": 1983}, {"name": "ColorInterpolator", "size": 2047}, {"name": "DateInterpolator", "size": 1375}, {"name": "Interpolator", "size": 8746}, {"name": "MatrixInterpolator", "size": 2202}, {"name": "NumberInterpolator", "size": 1382}, {"name": "ObjectInterpolator", "size": 1629}, {"name": "PointInterpolator", "size": 1675}, {"name": "RectangleInterpolator", "size": 2042} ] }, {"name": "ISchedulable", "size": 1041}, {"name": "Parallel", "size": 5176}, {"name": "Pause", "size": 449}, {"name": "Scheduler", "size": 5593}, {"name": "Sequence", "size": 5534}, {"name": "Transition", "size": 9201}, {"name": "Transitioner", "size": 19975}, {"name": "TransitionEvent", "size": 1116}, {"name": "Tween", "size": 6006} ] }, { "name": "data", "children": [ { "name": "converters", "children": [ {"name": "Converters", "size": 721}, {"name": "DelimitedTextConverter", "size": 4294}, {"name": "GraphMLConverter", "size": 9800}, {"name": "IDataConverter", "size": 1314}, {"name": "JSONConverter", "size": 2220} ] }, {"name": "DataField", "size": 1759}, {"name": "DataSchema", "size": 2165}, {"name": "DataSet", "size": 586}, {"name": "DataSource", "size": 3331}, {"name": "DataTable", "size": 772}, {"name": "DataUtil", "size": 3322} ] }, { "name": "display", "children": [ {"name": "DirtySprite", "size": 8833}, {"name": "LineSprite", "size": 1732}, {"name": "RectSprite", "size": 3623}, {"name": "TextSprite", "size": 10066} ] }, { "name": "flex", "children": [ {"name": "FlareVis", "size": 4116} ] }, { "name": "physics", "children": [ {"name": "DragForce", "size": 1082}, {"name": "GravityForce", "size": 1336}, {"name": "IForce", "size": 319}, {"name": "NBodyForce", "size": 10498}, {"name": "Particle", "size": 2822}, {"name": "Simulation", "size": 9983}, {"name": "Spring", "size": 2213}, {"name": "SpringForce", "size": 1681} ] }, { "name": "query", "children": [ {"name": "AggregateExpression", "size": 1616}, {"name": "And", "size": 1027}, {"name": "Arithmetic", "size": 3891}, {"name": "Average", "size": 891}, {"name": "BinaryExpression", "size": 2893}, {"name": "Comparison", "size": 5103}, {"name": "CompositeExpression", "size": 3677}, {"name": "Count", "size": 781}, {"name": "DateUtil", "size": 4141}, {"name": "Distinct", "size": 933}, {"name": "Expression", "size": 5130}, {"name": "ExpressionIterator", "size": 3617}, {"name": "Fn", "size": 3240}, {"name": "If", "size": 2732}, {"name": "IsA", "size": 2039}, {"name": "Literal", "size": 1214}, {"name": "Match", "size": 3748}, {"name": "Maximum", "size": 843}, { "name": "methods", "children": [ {"name": "add", "size": 593}, {"name": "and", "size": 330}, {"name": "average", "size": 287}, {"name": "count", "size": 277}, {"name": "distinct", "size": 292}, {"name": "div", "size": 595}, {"name": "eq", "size": 594}, {"name": "fn", "size": 460}, {"name": "gt", "size": 603}, {"name": "gte", "size": 625}, {"name": "iff", "size": 748}, {"name": "isa", "size": 461}, {"name": "lt", "size": 597}, {"name": "lte", "size": 619}, {"name": "max", "size": 283}, {"name": "min", "size": 283}, {"name": "mod", "size": 591}, {"name": "mul", "size": 603}, {"name": "neq", "size": 599}, {"name": "not", "size": 386}, {"name": "or", "size": 323}, {"name": "orderby", "size": 307}, {"name": "range", "size": 772}, {"name": "select", "size": 296}, {"name": "stddev", "size": 363}, {"name": "sub", "size": 600}, {"name": "sum", "size": 280}, {"name": "update", "size": 307}, {"name": "variance", "size": 335}
```

--------------------------------

### Prepare Release Version with Maven

Source: https://github.com/wicketstuff/core/blob/master/wicketstuff-jquery-ui-parent/RELEASE.md

Execute these Maven release plugin commands to prepare for a release. Ensure version numbers are updated in README.md and samples/HomePage.html, and that changes are committed and pushed.

```bash
mvn release:clean
mvn release:prepare
mvn release:perform
```

--------------------------------

### Deploy Snapshot Version with Maven

Source: https://github.com/wicketstuff/core/blob/master/wicketstuff-jquery-ui-parent/RELEASE.md

Use this Maven command to clean and deploy a snapshot version of the project.

```bash
$ mvn clean deploy -P snapshot
```

--------------------------------

### Override @SecureAutoMount Defaults

Source: https://github.com/wicketstuff/core/wiki/Servlet-Container-Authentication-and-Authorization

Example of overriding the default values for @SecureAutoMount annotation to customize path and mime extensions for secure and non-secure pages.

```java
@SecureAutoMount(defaultRoot="public", defaultMimeExtension="", secureRoot="private",secureMimeExtension="shtml")
```

--------------------------------

### Implement DataGrid in Java

Source: https://github.com/wicketstuff/core/wiki/projects/InMethodGrid

Initialize a DataGrid component by providing a data provider and a list of columns.

```java
        final List<Person> personList = ... ;
        final listDataProvider = new ListDataProvider(personList);

        List<IGridColumn> cols = (List) Arrays.asList(
            new PropertyColumn(new Model("First Name"), "firstName"),
            new PropertyColumn(new Model("Last Name"), "lastName"));
        DataGrid grid = new DefaultDataGrid("grid", new DataProviderAdapter(listDataProvider), cols);
        add(grid);
```

--------------------------------

### Annotate Resource with @ResourcePath

Source: https://github.com/wicketstuff/core/blob/master/wicketstuff-restannotations-parent/readme.md

Annotate your AbstractRestResource subclass with @ResourcePath to define its mounting path. This requires no specific setup within the resource class itself.

```java
package org.wicketstuff.rest.resource;

@ResourcePath("/mountedpath")
public class MountedResource extends AbstractRestResource
{
... 
}
```

--------------------------------

### Swarm GetAuthorities for TestingAuthenticationToken

Source: https://github.com/wicketstuff/core/wiki/Wicket-Security---4.-Spring-security

Provides GrantedAuthorities for a TestingAuthenticationToken based on username and password. This is a simplified example; real applications would fetch authorities from a database.

```java
private GrantedAuthority[] getAuthorities(String username, String password) {
		GrantedAuthority[] authorities = null;
		if (username != null && Objects.equal(username, password)) {
			authorities = new GrantedAuthority[1];
			if ("ceo".equals(username))
				authorities[0] = new GrantedAuthorityImpl("organisation.rights");
			else
				authorities[0] = new GrantedAuthorityImpl("department.rights");

			// the subject returned in AcegiLoginContext knows how to
			// convert these names to principals
		}
		return authorities;
	}
```

--------------------------------

### jQuery UI Tooltip JavaScript Example

Source: https://github.com/wicketstuff/core/wiki/jWicket-UI-Tooltip

This is the equivalent JavaScript code for configuring a jQuery UI tooltip with specific position and open event handlers.

```javascript
$('#component1').tooltip({position:{my:'center bottom-20',at:'center top'},open:function(event,ui){some js code;}});
```

--------------------------------

### Configure Sticky TopBar

Source: https://github.com/wicketstuff/core/blob/master/wicket-foundation/wicket-foundation-samples/src/main/java/org/wicketstuff/foundation/TopBarPage.html

Initializes a FoundationTopBarPanel with sticky behavior enabled for large screen sizes.

```java
TopBarOptions stickyConditionsOptions = new TopBarOptions();
    stickyConditionsOptions.setSticky(true);
    stickyConditionsOptions.setStickySizes(EnumSet.of(TopBarStickySize.LARGE));
    add(new FoundationTopBarPanel("stickyConditions", stickyConditionsOptions, new ArrayList<TopBarItem>(), new ArrayList<TopBarItem>()) {
        @Override
        public WebMarkupContainer createTitleContainer(String id) {
            return new EmptyPanel(id);
        }
        @Override
        public AbstractLink createLink(String id, String itemId) {
            return new Link<Void>(id) {
                @Override
                public void onClick() {
                }
            };
        }
    });
```

--------------------------------

### Example Saved Whiteboard JSON

Source: https://github.com/wicketstuff/core/wiki/Whiteboard

This JSON structure represents the data for a saved whiteboard. It includes background properties and a list of elements drawn on the whiteboard.

```json
{"background": {
    "height": 326,
    "width": 595.0481927710844,
    "left": -297.5240963855422,
    "type": "Background",
    "url": "http://localhost:8080/Documents/gmaps.jpg",
    "top": 163
}, "elements": [
    {
        "id": 5,
        "p2": 4,
        "color": "",
        "p1": 3,
        "trace": false,
        "hidden": false,
        "label": "",
        "type": "PencilCircle"
    },
    {
        "id": 0,
        "color": "",
        "trace": false,
        "hidden": false,
        "label": "",
        "type": "PointFree",
        "y": 105,
        "x": -527
    },
    {
        "id": 2,
        "p2": 1,
        "color": "",
        "p1": 0,
        "trace": false,
        "hidden": false,
        "label": "",
        "type": "PencilRect"
    },
    {
        "id": 1,
        "color": "",
        "trace": false,
        "hidden": false,
        "label": "",
        "type": "PointFree",
        "y": -100,
        "x": -157
    },
    {
        "id": 3,
        "color": "",
        "trace": false,
        "hidden": false,
        "label": "",
        "type": "PointFree",
        "y": 96,
        "x": 61
    },
    {
        "id": 4,
        "color": "",
        "trace": false,
        "hidden": false,
        "label": "",
        "type": "PointFree",
        "y": 78,
        "x": 88
    }
]}
```

--------------------------------

### Implement standard links

Source: https://github.com/wicketstuff/core/blob/master/wicket-foundation/wicket-foundation-samples/src/main/java/org/wicketstuff/foundation/TypePage.html

Links automatically inherit the Foundation primary color.

```html
<p>Links are very standard, and the <a href="http://www.youtube.com/watch?v=zT2aVoUkSDg">color is preset</a> to the Foundation primary color.</p>
```

--------------------------------

### Create Model from Object Property

Source: https://github.com/wicketstuff/core/wiki/LazyModel

Create a model from an object's property using the `from()` and `get()` methods. This is useful for accessing nested properties in a type-safe manner.

```java
    A a = ...;
    
    IModel<B> model = model(from(a).getB());
```
Tokens:
Raw