A Thymeleaf dialect for Apache Shiro tags.
implementation "com.github.theborakompanioni:thymeleaf-extras-shiro:${thymeleaf-shiro.version}"
<dependency>
<groupId>com.github.theborakompanioni</groupId>
<artifactId>thymeleaf-extras-shiro</artifactId>
<version>${thymeleaf-shiro.version}</version>
</dependency>
Download from Maven Central.
git clone https://github.com/theborakompanioni/thymeleaf-extras-shiro.git
<!DOCTYPE html>
<html xmlns:shiro="https://www.github.com/theborakompanioni/thymeleaf-extras-shiro">
<head>
<title>thymeleaf-extras-shiro</title>
</head>
<body>
<p shiro:guest="">Please <a href="login.html">login</a></p>
<p shiro:authenticated="">
Hello, <span shiro:principal=""></span>, how are you today?
</p>
</body>
</html>
The following examples show how to integrate the tags in your Thymeleaf templates. These are all implementations of the examples given in the JSP / GSP Tag Library Section of the Apache Shiro documentation.
Tags can be written in attribute or element notation:
<p shiro:anyTag>
Goodbye cruel World!
</p>
<shiro:anyTag>
<p>Hello World!</p>
</shiro:anyTag>
<p shiro:guest="">
Please <a href="login.html">Login</a>
</p>
<p shiro:user="">
Welcome back John! Not John? Click <a href="login.html">here<a> to login.
</p>
<a shiro:authenticated="" href="updateAccount.html">Update your contact information</a>
<p shiro:notAuthenticated="">
Please <a href="login.html">login</a> in order to update your credit card information.
</p>
<p>Hello, <span shiro:principal=""></span>, how are you today?</p>
or
<p>Hello, <shiro:principal/>, how are you today?</p>
Typed principal and principal property are also supported.
<a shiro:hasRole="administrator" href="admin.html">Administer the system</a>
<p shiro:lacksRole="administrator">
Sorry, you are not allowed to administer the system.
</p>
<p shiro:hasAllRoles="developer, project manager">
You are a developer and a project manager.
</p>
<p shiro:hasAnyRoles="developer, project manager, administrator">
You are a developer, project manager, or administrator.
</p>
<a shiro:hasPermission="user:create" href="createUser.html">Create a new User</a>
<p shiro:lacksPermission="user:delete">
Sorry, you are not allowed to delete user accounts.
</p>
<p shiro:hasAllPermissions="user:create, user:delete">
You can create and delete users.
</p>
<p shiro:hasAnyPermissions="user:create, user:delete">
You can create or delete users.
</p>
- Apache Shiro (Website): https://shiro.apache.org
- Apache Shiro (GitHub): https://github.com/apache/shiro
- Thymeleaf (Website): https://www.thymeleaf.org/
- Thymeleaf (GitHub): https://github.com/thymeleaf/thymeleaf
The project is licensed under the Apache License. See LICENSE for details.