From e9a1e9b32673d7723c4969a68a753380736c4135 Mon Sep 17 00:00:00 2001 From: Maniack Crudelis Date: Sun, 13 Jan 2019 20:42:36 +0100 Subject: [PATCH] English translation and typo --- scripts/backup | 10 ++++---- scripts/install | 66 +++++++++++++++++++++++++++---------------------- scripts/remove | 48 ++++++++++++++++++++--------------- scripts/restore | 40 ++++++++++++++++-------------- scripts/upgrade | 45 +++++++++++++++++++-------------- 5 files changed, 117 insertions(+), 92 deletions(-) diff --git a/scripts/backup b/scripts/backup index 0ee5734..911bdf3 100644 --- a/scripts/backup +++ b/scripts/backup @@ -29,7 +29,7 @@ domain=$(ynh_app_setting_get $app domain) #================================================= # STANDARD BACKUP STEPS #================================================= -# BACKUP OF THE MAIN DIRECTORIES OF THE APP +# BACKUP THE MAIN APP DIRECTORIES #================================================= CHECK_SIZE "$final_path" @@ -45,13 +45,13 @@ CHECK_SIZE "/opt/pihole" ynh_backup "/opt/pihole" #================================================= -# BACKUP OF THE NGINX CONFIGURATION +# BACKUP NGINX CONFIGURATION #================================================= ynh_backup "/etc/nginx/conf.d/$domain.d/$app.conf" #================================================= -# BACKUP OF THE PHP-FPM CONFIGURATION +# BACKUP PHP-FPM CONFIGURATION #================================================= ynh_backup "/etc/php5/fpm/pool.d/$app.conf" @@ -59,13 +59,13 @@ ynh_backup "/etc/php5/fpm/pool.d/$app.conf" #================================================= # SPECIFIC BACKUP #================================================= -# BACKUP OF THE CRON FILE +# BACKUP CRON FILE #================================================= ynh_backup "/etc/cron.d/pihole" #================================================= -# BACKUP OF SPECIFIC FILES +# BACKUP SPECIFIC FILES #================================================= ynh_backup "/usr/local/bin/pihole" diff --git a/scripts/install b/scripts/install index b45b9dd..536c88a 100644 --- a/scripts/install +++ b/scripts/install @@ -15,7 +15,8 @@ source _variables # MANAGE FAILURE OF THE SCRIPT #================================================= -ynh_abort_if_errors # Active trap pour arrêter le script si une erreur est détectée. +# Exit if an error occurs during the execution of the script +ynh_abort_if_errors #================================================= # RETRIEVE ARGUMENTS FROM THE MANIFEST @@ -62,16 +63,17 @@ ynh_app_setting_set $app overwrite_phpfpm "1" # FIND AND OPEN A PORT #================================================= -port=$(ynh_find_port 4711) # Cherche un port libre. +# Find a free port +port=$(ynh_find_port 4711) if [ $port -gt 4720 ] then ynh_die "The ports 4711 to 4720 are already in use. Pi-hole can't works on another port. Please try to free one of this ports." fi -# Ouvre le port dans le firewall +# Open this port ynh_exec_fully_quiet yunohost firewall allow --no-upnp TCP $port ynh_app_setting_set $app port $port -# Désactive le port 53 en upnp +# Disable the port 53 for upnp ynh_exec_fully_quiet yunohost firewall disallow Both 53 --no-reload ynh_exec_fully_quiet yunohost firewall allow Both 53 --no-upnp @@ -86,34 +88,37 @@ ynh_install_app_dependencies $app_depencencies #================================================= ynh_app_setting_set $app final_path $final_path -# Créer une copie du repo de pihole (nécessaire pour Gravity) +# Make a copy of local pihole repository (for Gravity) pihole_local_repo="/etc/.pihole" ynh_setup_source "$pihole_local_repo" -# Installe le dashboard admin +# Install admin dashboard ynh_setup_source "$final_path" admin_dashboard #================================================= # NGINX CONFIGURATION #================================================= +# Create a dedicated nginx config ynh_add_nginx_config #================================================= # CREATE DEDICATED USER #================================================= -ynh_system_user_create $app # Créer un utilisateur système dédié à l'app +# Create a dedicated system user +ynh_system_user_create $app #================================================= # PHP-FPM CONFIGURATION #================================================= -ynh_add_fpm_config # Créer le fichier de configuration du pool php-fpm et le configure. +# Create a dedicated php-fpm config +ynh_add_fpm_config #================================================= # SPECIFIC SETUP #================================================= -# CREATE THE DIRECTORIES AND POPULATE THEM +# CREATE DIRECTORIES AND POPULATE THEM #================================================= pihole_storage="/etc/pihole" @@ -123,7 +128,7 @@ chown $app: -R "$pihole_storage" pihole_dir="/opt/pihole" mkdir -p "$pihole_dir" -# Copie les scripts de Pi-hole +# Make a copy of Pi-Hole scripts cp -a "$pihole_local_repo/gravity.sh" "$pihole_dir/" cp -a $pihole_local_repo/advanced/Scripts/*.sh "$pihole_dir/" @@ -131,7 +136,7 @@ cp -a $pihole_local_repo/advanced/Scripts/*.sh "$pihole_dir/" cp -a "$pihole_local_repo/advanced/Scripts/COL_TABLE" "$pihole_dir/" #================================================= -# COPY THE PI-HOLE MAIN SCRIPT +# COPY PI-HOLE MAIN SCRIPT #================================================= cp -a "$pihole_local_repo/pihole" /usr/local/bin/ @@ -150,7 +155,7 @@ chown $dnsmasq_user:root /var/log/pihole.log # CREATE SUDOER FILE #================================================= -# Cette configuration sudoers autorise pihole à exécuter /usr/local/bin/pihole en root sans mot de passe. Pas plus. +# This sudoers config allow pihole to execute /usr/local/bin/pihole as root without password. Nothing more. cp "$pihole_local_repo/advanced/pihole.sudo" /etc/sudoers.d/pihole echo "$app ALL=NOPASSWD: /usr/local/bin/pihole" >> /etc/sudoers.d/pihole # echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" >> /etc/sudoers.d/pihole @@ -171,26 +176,27 @@ sed -i "/# su #/d;" "$pihole_storage/logrotate" FTL_temp_path=$(mktemp -d) ynh_setup_source "$FTL_temp_path" FTL -# Plutôt que télécharger le binaire C, on le compile nous-même. +# Instead of downloading a binary file, we're going to compile it ( cd "$FTL_temp_path" ynh_exec_warn_less make ynh_exec_warn_less make install ) ynh_secure_remove "$FTL_temp_path" cp "../conf/pihole-FTL.conf" "$pihole_storage" -ynh_store_file_checksum "$pihole_storage/pihole-FTL.conf" # Enregistre la somme de contrôle du fichier de config +# Calculate and store the config file checksum into the app settings +ynh_store_file_checksum "$pihole_storage/pihole-FTL.conf" cp -a $pihole_local_repo/advanced/pihole-FTL.service /etc/init.d/pihole-FTL chmod +x /etc/init.d/pihole-FTL ynh_exec_warn_less systemctl enable pihole-FTL #================================================= -# BUILD THE VARIABLES FILE +# BUILD VARIABLES FILE #================================================= setupVars="$pihole_storage/setupVars.conf" -# Trouve l'interface réseau par défaut +# Get the default network interface main_iface=$(ip route | grep default | awk '{print $5;}') echo "PIHOLE_INTERFACE=$main_iface" > $setupVars echo "IPV4_ADDRESS=127.0.0.1" >> $setupVars @@ -205,17 +211,18 @@ fi echo "QUERY_LOGGING=$query_logging" >> $setupVars echo "INSTALL_WEB=true" >> $setupVars -ynh_store_file_checksum "$setupVars" # Enregistre la somme de contrôle du fichier de config +# Calculate and store the config file checksum into the app settings +ynh_store_file_checksum "$setupVars" #================================================= -# SET UP THE DNSMASQ CONFIG +# SET UP DNSMASQ CONFIG #================================================= ynh_systemd_action --action=stop --service_name=dnsmasq pihole_dnsmasq_config="/etc/dnsmasq.d/01-pihole.conf" cp "$pihole_local_repo/advanced/01-pihole.conf" $pihole_dnsmasq_config -# On utilise les dns de /etc/resolv.dnsmasq.conf +# Use dns from /etc/resolv.dnsmasq.conf ynh_replace_string "@DNS1@" "" $pihole_dnsmasq_config ynh_replace_string "@DNS2@" "" $pihole_dnsmasq_config ynh_replace_string "^no-resolv" "#no-resolv" $pihole_dnsmasq_config @@ -230,25 +237,26 @@ fi # Fix a too recent option for our dnsmasq version. ynh_replace_string "log-queries=extra" "log-queries" $pihole_dnsmasq_config -ynh_store_file_checksum "$pihole_dnsmasq_config" # Enregistre la somme de contrôle du fichier de config +# Calculate and store the config file checksum into the app settings +ynh_store_file_checksum "$pihole_dnsmasq_config" -# Pour éviter un conflit entre les config de dnsmasq, il faut commenter cache-size dans la config par défaut. +# To prevent any conflict with the original dnsmasq config, comment cache-size in the original config. ynh_replace_string "^cache-size=" "#pihole# cache-size=" /etc/dnsmasq.conf #================================================= # CONFIGURE DNS FOR THE LOCAL DOMAINS #================================================= -# Trouve l'ipv4 associée à l'interface trouvée +# Find the IP associated to the network interface localipv4=$(ip address | grep "${main_iface}\$" | awk '{print $2;}' | cut -d/ -f1) -# Liste les domaines de yunohost +# List all YunoHost domains while read perdomain do - # Commente les résolutions du domaine sur 127.0.0.1, qui risquerait de bloquer la résolution sur le réseau local + # Comment domain resolution in /etc/hosts on 127.0.0.1, because they can interfere with the local network resolution. ynh_replace_string "^127.0.0.1.*$perdomain" "#Commented by pihole# &" /etc/hosts - # Et ajoute une résolution sur l'ip local à la place, si elle n'existe pas déjà + # And add a resolution on the local IP instead grep -q "^$localipv4.*$perdomain" /etc/hosts || \ echo "$localipv4 $perdomain #Added by pihole#" >> /etc/hosts done <<< "$(yunohost domain list | grep "\." | sed 's/.*: \|.*- //')" @@ -297,7 +305,7 @@ ynh_exec_fully_quiet yunohost firewall allow UDP 67 --no-upnp ynh_systemd_action --action=restart --service_name=dnsmasq #================================================= -# INSTALL THE CRON JOB +# INSTALL CRON JOB #================================================= cp $pihole_local_repo/advanced/pihole.cron /etc/cron.d/pihole @@ -318,7 +326,7 @@ ynh_exec_warn_less /opt/pihole/gravity.sh ynh_systemd_action --action=restart --service_name=pihole-FTL #================================================= -# SET UP THE CONF_REGEN HOOK +# SET UP CONF_REGEN HOOK #================================================= cp ../conf/dnsmasq_regenconf_hook /usr/share/yunohost/hooks/conf_regen/50-dnsmasq_$app @@ -326,7 +334,7 @@ cp ../conf/dnsmasq_regenconf_hook /usr/share/yunohost/hooks/conf_regen/50-dnsmas #================================================= # GENERIC FINALISATION #================================================= -# ENABLE SERVICE IN ADMIN PANEL +# ADVERTISE SERVICE IN ADMIN PANEL #================================================= yunohost service add pihole-FTL --log "/var/log/pihole-FTL.log" @@ -357,6 +365,6 @@ else dhcp_alert="" fi -message="${dhcp_alert}If you facing an issue or want to improve this app, please open a new issue in this project: https://github.com/YunoHost-Apps/pihole_ynh" +message="${dhcp_alert}If you're facing an issue or want to improve this app, please open a new issue in this project: https://github.com/YunoHost-Apps/pihole_ynh" ynh_send_readme_to_admin --app_message="$message" --recipients="$admin" diff --git a/scripts/remove b/scripts/remove index 8e35d16..365d51c 100755 --- a/scripts/remove +++ b/scripts/remove @@ -21,17 +21,18 @@ port=$(ynh_app_setting_get $app port) #================================================= # STANDARD REMOVE #================================================= -# DISABLE SERVICE IN ADMIN PANEL +# REMOVE SERVICE FROM ADMIN PANEL #================================================= -if yunohost service status | grep -q pihole-FTL # Test l'existence du service dans Yunohost +# Check if the service is declared in YunoHost +if yunohost service status | grep -q pihole-FTL then ynh_print_info "Remove pihole-FTL service" >&2 yunohost service remove pihole-FTL fi #================================================= -# STOP THE SERVICE PIHOLE-FTL +# STOP PIHOLE-FTL SERVICE #================================================= ynh_systemd_action --action=stop --service_name=pihole-FTL @@ -42,31 +43,38 @@ rm -f "/etc/init.d/pihole-FTL" "/usr/bin/pihole-FTL" "/var/run/pihole-FTL.pid" " # REMOVE DEPENDENCIES #================================================= +# Remove metapackage and its dependencies ynh_remove_app_dependencies #================================================= # REMOVE THE DIRECTORIES OF THE APP #================================================= -ynh_secure_remove "/etc/pihole" # Suppression du dossier de stockage l'application -ynh_secure_remove "/opt/pihole" # Suppression du dossier l'application -ynh_secure_remove "/var/www/pihole" # Suppression de l'interface de l'application -ynh_secure_remove "/etc/.pihole" # Suppression du clone local du dépôt +# Remove storage directory +ynh_secure_remove "/etc/pihole" +# Remove app directory +ynh_secure_remove "/opt/pihole" +# Remove admin panel directory +ynh_secure_remove "/var/www/pihole" +# Remove local clone of the repository +ynh_secure_remove "/etc/.pihole" #================================================= -# REMOVE THE NGINX CONFIGURATION +# REMOVE NGINX CONFIGURATION #================================================= -ynh_remove_nginx_config # Suppression de la configuration nginx +# Remove the dedicated nginx config +ynh_remove_nginx_config #================================================= -# REMOVE THE PHP-FPM CONFIGURATION +# REMOVE PHP-FPM CONFIGURATION #================================================= -ynh_remove_fpm_config # Suppression de la configuration du pool php-fpm +# Remove the dedicated php-fpm config +ynh_remove_fpm_config #================================================= -# CLOSE A PORT +# CLOSE PORTS #================================================= if yunohost firewall list | grep -q "\- $port$" @@ -84,7 +92,7 @@ fi #================================================= # SPECIFIC REMOVE #================================================= -# REMOVE THE CRON FILE +# REMOVE CRON FILE #================================================= ynh_secure_remove "/etc/cron.d/pihole" @@ -93,19 +101,19 @@ ynh_secure_remove "/etc/cron.d/pihole" # REMOVE OTHER FILES #================================================= -# Suppression des log +# Remove logs ynh_secure_remove "/var/log/pihole.log" ynh_secure_remove "/var/log/pihole-FTL.log" -# Remove the main script +# Remove main script ynh_secure_remove "/usr/local/bin/pihole" ynh_secure_remove "/etc/bash_completion.d/pihole" -# Remove the sudoer file +# Remove sudoer file ynh_secure_remove "/etc/sudoers.d/pihole" #================================================= -# REMOVE THE DNSMASQ CONFIG +# REMOVE DNSMASQ CONFIG #================================================= ynh_systemd_action --action=stop --service_name=dnsmasq @@ -120,10 +128,10 @@ ynh_replace_string "#pihole# " "" /etc/dnsmasq.conf # CLEAN /etc/hosts #================================================= -# Restaure les résolutions qui avaient été commentées par pihole +# Uncomment lines in /etc/hosts sed -i "s/#Commented by pihole# //g" /etc/hosts -# Et supprime les lignes ajoutées par pihole +# And remove extra lines, added by PiHole sed -i "/#Added by pihole#/d" /etc/hosts #================================================= @@ -133,7 +141,7 @@ sed -i "/#Added by pihole#/d" /etc/hosts ynh_systemd_action --action=restart --service_name=dnsmasq #================================================= -# REMOVE THE CONF_REGEN HOOK +# REMOVE CONF_REGEN HOOK #================================================= ynh_secure_remove /usr/share/yunohost/hooks/conf_regen/50-dnsmasq_$app diff --git a/scripts/restore b/scripts/restore index c78c12b..cd42331 100644 --- a/scripts/restore +++ b/scripts/restore @@ -48,13 +48,13 @@ ynh_maintenance_mode_ON #================================================= # STANDARD RESTORE STEPS #================================================= -# RESTORE OF THE NGINX CONFIGURATION +# RESTORE THE NGINX CONFIGURATION #================================================= ynh_restore_file "/etc/nginx/conf.d/$domain.d/$app.conf" #================================================= -# RESTORE OF THE MAIN DIRECTORIES OF THE APP +# RESTORE THE MAIN DIRECTORIES OF THE APP #================================================= ynh_restore_file "$final_path" @@ -66,20 +66,21 @@ ynh_restore_file "/etc/pihole" ynh_restore_file "/opt/pihole" #================================================= -# RECREATE OF THE DEDICATED USER +# RECREATE THE DEDICATED USER #================================================= -ynh_system_user_create $app # Recreate the dedicated user, if not exist +# Create the dedicated user (if not existing) +ynh_system_user_create $app #================================================= # RESTORE USER RIGHTS #================================================= -# Les fichiers appartiennent à root +# Restore permissions on app files chown $app: -R "/etc/pihole" #================================================= -# RESTORE OF THE PHP-FPM CONFIGURATION +# RESTORE THE PHP-FPM CONFIGURATION #================================================= ynh_restore_file "/etc/php5/fpm/pool.d/$app.conf" @@ -93,13 +94,13 @@ ynh_restore_file "/etc/php5/fpm/pool.d/$app.conf" ynh_install_app_dependencies $app_depencencies #================================================= -# ENABLE SERVICE IN ADMIN PANEL +# ADVERTISE SERVICE IN ADMIN PANEL #================================================= yunohost service add pihole-FTL --log "/var/log/pihole-FTL.log" #================================================= -# RESTORE OF THE CRON FILE +# RESTORE THE CRON FILE #================================================= ynh_restore_file "/etc/cron.d/pihole" @@ -114,7 +115,7 @@ dnsmasq_user=$(grep DNSMASQ_USER= /etc/init.d/dnsmasq | cut -d'"' -f2) chown $dnsmasq_user:root /var/log/pihole.log #================================================= -# RESTORE OF SPECIFIC FILES +# RESTORE SPECIFIC FILES #================================================= ynh_restore_file "/usr/local/bin/pihole" @@ -128,7 +129,7 @@ ynh_restore_file "/usr/bin/pihole-FTL" ynh_restore_file "/usr/share/yunohost/hooks/conf_regen/50-dnsmasq_$app" #================================================= -# RESTORE OF DNSMASQ CONFIG +# RESTORE DNSMASQ CONFIG #================================================= ynh_systemd_action --action=stop --service_name=dnsmasq @@ -141,25 +142,25 @@ test -e "${YNH_APP_BACKUP_DIR}/etc/dnsmasq.d/03-pihole-wildcard.conf" && \ test -e "${YNH_APP_BACKUP_DIR}/etc/dnsmasq.d/04-pihole-static-dhcp.conf" && \ ynh_restore_file "/etc/dnsmasq.d/04-pihole-static-dhcp.conf" -# Pour éviter un conflit entre les config de dnsmasq, il faut commenter cache-size dans la config par défaut. +# To prevent any conflict with the original dnsmasq config, comment cache-size in the original config. ynh_replace_string "^cache-size=" "#pihole# cache-size=" /etc/dnsmasq.conf #================================================= # CONFIGURE DNS FOR THE LOCAL DOMAINS #================================================= -# Trouve l'interface réseau par défaut +# Get the default network interface main_iface=$(ip route | grep default | awk '{print $5;}') -# Trouve l'ipv4 associée à l'interface trouvée +# Find the IP associated to the network interface localipv4=$(ip address | grep "${main_iface}\$" | awk '{print $2;}' | cut -d/ -f1) -# Liste les domaines de yunohost +# List all YunoHost domains while read perdomain do - # Commente les résolutions du domaine sur 127.0.0.1, qui risquerait de bloquer la résolution sur le réseau local + # Comment domain resolution in /etc/hosts on 127.0.0.1, because they can interfere with the local network resolution. sed -i "s/^127.0.0.1.*$perdomain/#Commented by pihole# &/g" /etc/hosts - # Et ajoute une résolution sur l'ip local à la place, si elle n'existe pas déjà + # And add a resolution on the local IP instead grep -q "^$localipv4.*$perdomain" /etc/hosts || \ echo "$localipv4 $perdomain #Added by pihole#" >> /etc/hosts done <<< "$(yunohost domain list | grep "\." | sed 's/.*: \|.*- //')" @@ -171,7 +172,7 @@ done <<< "$(yunohost domain list | grep "\." | sed 's/.*: \|.*- //')" ynh_systemd_action --action=restart --service_name=dnsmasq #================================================= -# UPDATE THE VARIABLES FILE +# UPDATE VARIABLES FILE #================================================= setupVars="/etc/pihole/setupVars.conf" @@ -180,7 +181,8 @@ echo "PIHOLE_INTERFACE=$main_iface" > $setupVars ynh_replace_string "^PIHOLE_INTERFACE=.*" "PIHOLE_INTERFACE=$main_iface" $setupVars ynh_replace_string "^IPV4_ADDRESS=.*" "IPV4_ADDRESS=127.0.0.1" $setupVars -ynh_store_file_checksum "$setupVars" # Enregistre la somme de contrôle du fichier de config +# Recalculate and store the checksum of the file for the next upgrade. +ynh_store_file_checksum "$setupVars" #================================================= # START PIHOLE-FTL @@ -218,6 +220,6 @@ else dhcp_alert="" fi -message="${dhcp_alert}If you facing an issue or want to improve this app, please open a new issue in this project: https://github.com/YunoHost-Apps/pihole_ynh" +message="${dhcp_alert}If you're facing an issue or want to improve this app, please open a new issue in this project: https://github.com/YunoHost-Apps/pihole_ynh" ynh_send_readme_to_admin --app_message="$message" --recipients="$admin" diff --git a/scripts/upgrade b/scripts/upgrade index 236cfe8..9107bc3 100644 --- a/scripts/upgrade +++ b/scripts/upgrade @@ -79,7 +79,8 @@ ynh_abort_if_errors # CHECK THE PATH #================================================= -path_url=$(ynh_normalize_url_path $path_url) # Vérifie et corrige la syntaxe du path. +# Normalize the URL path syntax +path_url=$(ynh_normalize_url_path $path_url) #================================================= # ACTIVATE MAINTENANCE MODE @@ -102,9 +103,9 @@ ynh_install_app_dependencies $app_depencencies pihole_local_repo="/etc/.pihole" if [ "$upgrade_type" == "UPGRADE_APP" ] then - # Update la copie du repo de pihole (nécessaire pour Gravity) + # Update the local copy pihole repository (for Gravity) ynh_setup_source "$pihole_local_repo" - # Update le dashboard admin + # Update admin dashboard ynh_setup_source "$final_path" admin_dashboard fi @@ -115,6 +116,7 @@ fi # Overwrite the nginx configuration only if it's allowed if [ $overwrite_nginx -eq 1 ] then + # Create a dedicated nginx config ynh_add_nginx_config fi @@ -122,7 +124,8 @@ fi # CREATE DEDICATED USER #================================================= -ynh_system_user_create $app # Create the dedicated user, if not exist +# Create a dedicated user (if not existing) +ynh_system_user_create $app #================================================= # PHP-FPM CONFIGURATION @@ -131,7 +134,8 @@ ynh_system_user_create $app # Create the dedicated user, if not exist # Overwrite the php-fpm configuration only if it's allowed if [ $overwrite_phpfpm -eq 1 ] then - ynh_add_fpm_config # Créer le fichier de configuration du pool php-fpm et le configure. + # Create a dedicated php-fpm config + ynh_add_fpm_config fi #================================================= @@ -140,7 +144,6 @@ fi # UPDATE PI-HOLE SCRIPTS #================================================= -# Update les scripts de Pi-hole pihole_dir="/opt/pihole" cp -a "$pihole_local_repo/gravity.sh" "$pihole_dir/" cp -a $pihole_local_repo/advanced/Scripts/*.sh "$pihole_dir/" @@ -149,7 +152,7 @@ cp -a $pihole_local_repo/advanced/Scripts/*.sh "$pihole_dir/" cp -a "$pihole_local_repo/advanced/Scripts/COL_TABLE" "$pihole_dir/" #================================================= -# Copy the Pi-hole main script +# COPY PI-HOLE MAIN SCRIPT #================================================= cp -a "$pihole_local_repo/pihole" /usr/local/bin/ @@ -159,7 +162,7 @@ cp -a "$pihole_local_repo/advanced/bash-completion/pihole" /etc/bash_completion. # CREATE SUDOER FILE #================================================= -# Cette configuration sudoers autorise pihole à exécuter /usr/local/bin/pihole en root sans mot de passe. Pas plus. +# This sudoers config allow pihole to execute /usr/local/bin/pihole as root without password. Nothing more. cp "$pihole_local_repo/advanced/pihole.sudo" /etc/sudoers.d/pihole echo "$app ALL=NOPASSWD: /usr/local/bin/pihole" >> /etc/sudoers.d/pihole chmod 0440 /etc/sudoers.d/pihole @@ -174,7 +177,7 @@ dnsmasq_user=$(grep DNSMASQ_USER= /etc/init.d/dnsmasq | cut -d'"' -f2) sed -i "/# su #/d;" "$pihole_storage/logrotate" #================================================= -# UPDATE OF PIHOLE-FTL +# UPDATE PIHOLE-FTL #================================================= ynh_systemd_action --action=stop --service_name=pihole-FTL @@ -185,19 +188,21 @@ then FTL_temp_path=$(mktemp -d) ynh_setup_source "$FTL_temp_path" FTL - # Plutôt que télécharger le binaire C, on le compile nous-même. + # Instead of downloading a binary file, we're going to compile it ( cd "$FTL_temp_path" ynh_exec_warn_less make ynh_exec_warn_less make install ) ynh_secure_remove "$FTL_temp_path" fi -# Overwrite the pihole-FTL config file only if it's allowed +# Overwrite pihole-FTL config file only if it's allowed if [ $overwrite_ftl -eq 1 ] then - ynh_backup_if_checksum_is_different "$pihole_storage/pihole-FTL.conf" # Créé un backup du fichier de config si il a été modifié. + # Verify the checksum of a file, stored by `ynh_store_file_checksum` in the install script. + ynh_backup_if_checksum_is_different "$pihole_storage/pihole-FTL.conf" cp "../conf/pihole-FTL.conf" "$pihole_storage" - ynh_store_file_checksum "$pihole_storage/pihole-FTL.conf" # Enregistre la somme de contrôle du fichier de config + # Recalculate and store the checksum of the file for the next upgrade. + ynh_store_file_checksum "$pihole_storage/pihole-FTL.conf" fi cp -a $pihole_local_repo/advanced/pihole-FTL.service /etc/init.d/pihole-FTL @@ -205,7 +210,7 @@ chmod +x /etc/init.d/pihole-FTL ynh_exec_warn_less systemctl enable pihole-FTL #================================================= -# BUILD THE VARIABLES FILE +# BUILD VARIABLES FILE #================================================= setupVars="$pihole_storage/setupVars.conf" @@ -213,9 +218,10 @@ setupVars="$pihole_storage/setupVars.conf" # Overwrite the setupVars config file only if it's allowed if [ $overwrite_setupvars -eq 1 ] then - ynh_backup_if_checksum_is_different "$setupVars" # Créé un backup du fichier de config si il a été modifié. + # Verify the checksum of a file, stored by `ynh_store_file_checksum` in the install script. + ynh_backup_if_checksum_is_different "$setupVars" - # Trouve l'interface réseau par défaut + # Get the default network interface main_iface=$(ip route | grep default | awk '{print $5;}') echo "PIHOLE_INTERFACE=$main_iface" > $setupVars echo "IPV4_ADDRESS=127.0.0.1" >> $setupVars @@ -230,11 +236,12 @@ then echo "QUERY_LOGGING=$query_logging" >> $setupVars echo "INSTALL_WEB=true" >> $setupVars - ynh_store_file_checksum "$setupVars" # Enregistre la somme de contrôle du fichier de config + # Recalculate and store the checksum of the file for the next upgrade. + ynh_store_file_checksum "$setupVars" fi #================================================= -# UPDATE THE CRON JOB +# UPDATE CRON JOB #================================================= cp $pihole_local_repo/advanced/pihole.cron /etc/cron.d/pihole @@ -248,7 +255,7 @@ ynh_replace_string ".*updatechecker.*" "#&" /etc/cron.d/pihole ynh_systemd_action --action=restart --service_name=pihole-FTL #================================================= -# UPDATE THE CONF_REGEN HOOK +# UPDATE CONF_REGEN HOOK #================================================= cp ../conf/dnsmasq_regenconf_hook /usr/share/yunohost/hooks/conf_regen/50-dnsmasq_$app