Tomas Cohen Arazi
4e7734ce33
This patch introduces the koha-sitemap script. This script wraps calls to the misc/cronjobs/sitemap.pl script so it can be done easily instance-wise. It sets /var/lib/koha/${instance}/sitemap as the destination directory for the sitemap files. A followup will make them available through an Apache configuration entry. koha-functions.sh is provided with a handy is_sitemap_enabled function so we can later add filters to other commands (koha-list, koha-foreach, etc). Exposes sitemap files to apache. This is suitable for including the sitemap in the robots.txt file as proposed in http://www.sitemaps.org/protocol.html#submit_robots Note: it depends on Apache 2.4+ so we can patch the file as needed. Older Apache users will be warned that they need to tweak the apache files on their own. To test: - You can build a package out of this patchset, or do the following on a kohadevbox cp debian/scripts/koha-functions.sh /usr/share/koha/bin - Run $ debian/scripts/koha-sitemap --help - Go through all the options (--enable, --disable, generate). (a) --enable: - debian/scripts/koha-sitemap --enable kohadev => SUCCESS: /var/lib/koha/kohadev/sitemap.enabled is created - call it again, a suitable warning is raised and the file is still there (b) debian/scripts/koha-sitemap --disable kohadev => SUCCESS: /var/lib/koha/kohadev/sitemap.enabled is deleted - call it again, a suitable warning is raised and the file does not exist (c) --generate: - debian/scripts/koha-sitemap --generate kohadev => SUCCESS: sitemapindex.xml and sitemap000X.xml files are generated in /var/lib/koha/kohadev/sitemap/ - Sign off :-D Sponsored-by: Orex Digital Signed-off-by: Frédéric Demians <f.demians@tamil.fr> Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>
208 lines
5.3 KiB
Bash
Executable file
208 lines
5.3 KiB
Bash
Executable file
#!/bin/bash
|
|
#
|
|
# Copyright 2016 Theke Solutions
|
|
#
|
|
# This file is part of Koha.
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
set -e
|
|
|
|
. /lib/lsb/init-functions
|
|
|
|
# Read configuration variable file if it is present
|
|
[ -r /etc/default/koha-common ] && . /etc/default/koha-common
|
|
|
|
# include helper functions
|
|
if [ -f "/usr/share/koha/bin/koha-functions.sh" ]; then
|
|
. "/usr/share/koha/bin/koha-functions.sh"
|
|
else
|
|
echo "Error: /usr/share/koha/bin/koha-functions.sh not present." 1>&2
|
|
exit 1
|
|
fi
|
|
|
|
usage()
|
|
{
|
|
local scriptname=$(basename $0)
|
|
|
|
cat <<EOF
|
|
$scriptname
|
|
|
|
This script lets you manage sitemaps for your Koha instances.
|
|
|
|
Usage:
|
|
$scriptname --enable|--disable instancename1 [instancename2]
|
|
$scriptname --generate instancename1 [instancename2]
|
|
$scriptname -h|--help
|
|
|
|
--enable Enable sitemap generation for the specified instances
|
|
--disable Disable sitemap generation for the specified instances
|
|
--generate (Re)generate stiemap for the specified instances
|
|
--quiet|-q Make the script quiet about non existent instance names
|
|
(useful for calling from another scripts).
|
|
--help|-h Display this help message
|
|
|
|
EOF
|
|
}
|
|
|
|
enable_sitemap()
|
|
{
|
|
local instance=$1
|
|
local libdir="/var/lib/koha"
|
|
|
|
if is_sitemap_enabled $instance; then
|
|
[ "$quiet" = "no" ] && \
|
|
warn "Sitemap already enabled for ${instance}"
|
|
else
|
|
|
|
sudo -u "$instance-koha" \
|
|
touch $libdir/$instance/sitemap.enabled
|
|
|
|
[ "$quiet" = "no" ] && \
|
|
warn "Sitemap enabled for ${instance}"
|
|
fi
|
|
}
|
|
|
|
disable_sitemap()
|
|
{
|
|
local instance=$1
|
|
local libdir="/var/lib/koha"
|
|
|
|
if is_sitemap_enabled $instance; then
|
|
sudo -u "$instance-koha" \
|
|
rm -f $libdir/$instance/sitemap.enabled
|
|
[ "$quiet" = "no" ] && \
|
|
warn "Sitemap disabled for ${instance}"
|
|
else
|
|
[ "$quiet" = "no" ] && \
|
|
warn "Sitemap already disabled for ${instance}"
|
|
fi
|
|
}
|
|
|
|
generate_sitemap()
|
|
{
|
|
local instance=$1
|
|
local sitemapdir="/var/lib/koha/$instance/sitemap"
|
|
|
|
if ! is_sitemap_enabled $instance; then
|
|
[ "$quiet" = "no" ] && \
|
|
warn "Sitemap not enabled for ${instance}."
|
|
else
|
|
if [ ! -d "$sitemapdir" ]; then
|
|
# Need to create directory
|
|
[ "$quiet" = "no" ] && \
|
|
warn "Sitemap directory for ${instance} doesn't exist. Creating."
|
|
sudo -u "$instance-koha" \
|
|
mkdir -p "$sitemapdir"
|
|
fi
|
|
|
|
if sudo -u "$instance-koha" -H \
|
|
env PERL5LIB=/usr/share/koha/lib \
|
|
KOHA_CONF="/etc/koha/sites/$instance/koha-conf.xml" \
|
|
/usr/share/koha/bin/cronjobs/sitemap.pl \
|
|
--dir $sitemapdir ; then
|
|
return 0
|
|
else
|
|
return 1
|
|
fi
|
|
fi
|
|
}
|
|
|
|
check_env_and_warn()
|
|
{
|
|
local apache_version_ok="no"
|
|
|
|
if /usr/sbin/apache2ctl -v | grep -q -v "Server version: Apache/2.4"; then
|
|
[ "$quiet" = "no" ] && \
|
|
cat 1>&2 <<EOM
|
|
WARNING: the shipped Apache configuration requires version 2.4.x and you don't have that.
|
|
Sitemap files will be generated, but refer to the docs to make them publicly available.
|
|
EOM
|
|
fi
|
|
}
|
|
|
|
set_action()
|
|
{
|
|
if [ "$op" = "" ]; then
|
|
op=$1
|
|
else
|
|
die "Error: only one action can be specified."
|
|
fi
|
|
}
|
|
|
|
op=""
|
|
quiet="no"
|
|
|
|
# Read command line parameters
|
|
while [ $# -gt 0 ]; do
|
|
|
|
case "$1" in
|
|
-h|--help)
|
|
usage ; exit 0 ;;
|
|
-q|--quiet)
|
|
quiet="yes"
|
|
shift ;;
|
|
--enable)
|
|
set_action "enable"
|
|
shift ;;
|
|
--disable)
|
|
set_action "disable"
|
|
shift ;;
|
|
--generate)
|
|
set_action "generate"
|
|
shift ;;
|
|
-*)
|
|
die "Error: invalid option switch ($1)" ;;
|
|
*)
|
|
# We expect the remaining stuff are the instance names
|
|
break ;;
|
|
esac
|
|
|
|
done
|
|
|
|
if [ $# -gt 0 ]; then
|
|
# We have at least one instance name
|
|
for name in "$@"; do
|
|
|
|
if is_instance $name; then
|
|
|
|
case $op in
|
|
"generate")
|
|
generate_sitemap $name
|
|
;;
|
|
"enable")
|
|
enable_sitemap $name
|
|
;;
|
|
"disable")
|
|
disable_sitemap $name
|
|
;;
|
|
*)
|
|
usage
|
|
;;
|
|
esac
|
|
|
|
else
|
|
if [ "$quiet" = "no" ]; then
|
|
warn "Error: Invalid instance name $name"
|
|
fi
|
|
fi
|
|
|
|
done
|
|
else
|
|
if [ "$quiet" = "no" ]; then
|
|
warn "Error: you must provide at least one instance name"
|
|
fi
|
|
fi
|
|
|
|
exit 0
|