Add shellhooks plugin

manifests/plugin/shellhooks.pp

@@ -0,0 +1,30 @@
+# = Foreman Proxy Shelhooks plugin
+#
+# This class installs the Shellhooks plugin
+#
+# === Parameters:
+#
+# $directory::                Absolute path to directory with executables
+#
+# === Advanced parameters:
+#
+# $enabled::                  enables/disables the shellhooks plugin
+#
+# $listen_on::                proxy feature listens on http, https, or both
+#
+# $version::                  plugin package version, it's passed to ensure parameter of package resource
+#                             can be set to specific version number, 'latest', 'present' etc.
+#
+class foreman_proxy::plugin::shellhooks (
+  Optional[String] $version = undef,
+  Boolean $enabled = true,
+  Stdlib::Absolutepath $directory = '/var/lib/foreman-proxy/shellhooks',
+  Foreman_proxy::ListenOn $listen_on = 'https',
+) {
+  foreman_proxy::plugin::module { 'shellhooks':
+    enabled   => $enabled,
+    feature   => 'shellhooks',
+    listen_on => $listen_on,
+    version   => $version,
+  }
+}

spec/classes/foreman_proxy__plugin__shellhooks_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe 'foreman_proxy::plugin::shellhooks' do
+  on_plugin_os.each do |os, os_facts|
+    context "on #{os}" do
+      let(:facts) { os_facts }
+      let(:pre_condition) { 'include foreman_proxy' }
+
+      describe 'with default settings' do
+        it { should contain_foreman_proxy__plugin__module('shellhooks') }
+        it 'shellhooks.yml should contain the correct configuration' do
+          verify_exact_contents(catalogue, '/etc/foreman-proxy/settings.d/shellhooks.yml', [
+            '---',
+            ':enabled: https',
+            ':directory: /var/lib/foreman-proxy/shellhooks'
+          ])
+        end
+      end
+
+      describe 'with overwritten parameters' do
+        let :params do
+          { :directory => '/opt/custom_shellhooks' }
+        end
+
+        it 'shellhooks.yml should contain the correct configuration' do
+          verify_exact_contents(catalogue, '/etc/foreman-proxy/settings.d/shellhooks.yml', [
+            '---',
+            ':enabled: https',
+            ':directory: /opt/custom_shellhooks',
+          ])
+        end
+      end
+    end
+  end
+end

templates/plugin/shellhooks.yml.erb

@@ -0,0 +1,5 @@
+---
+# always enable HTTPS only
+:enabled: <%= @module_enabled %>
+# directory with executables
+:directory: <%= scope.lookupvar("foreman_proxy::plugin::shellhooks::directory") %>