# This script is probably broken and not tested! # https://forum.virtualmin.com/t/add-snappymail-to-install-scripts/112560 # script_snappymail_desc() sub script_snappymail_desc { return "SnappyMail"; } sub script_snappymail_uses { return ( "php" ); } sub script_snappymail_longdesc { return "SnappyMail Webmail is a browser-based multilingual IMAP client with an application-like user interface"; } # script_snappymail_versions() sub script_snappymail_versions { return ( "2.37.3" ); } sub script_snappymail_version_desc { local ($ver) = @_; return &compare_versions($ver, "2.7") >= 0 ? "$ver" : "$ver (Un-supported)"; } sub script_snappymail_category { return "Email"; } sub script_snappymail_php_modules { local ($dbtype, $dbname) = split(/_/, $opts->{'db'}, 2); local @modules = ( "zlib", "mbstring" ); push(@modules, $dbtype eq "mysql" ? "pdo_mysql" : $dbtype eq "sqlite" ? "pdo_sqlite" : "pdo_pgsql"); return @modules; } sub script_snappymail_php_optional_modules { return ( "gd", "openssl", "sockets", "xxtea", "curl", "intl", "ldap", "zip", "gmagick", "imagick" ); } sub script_snappymail_dbs { return ("mysql", "postgres", "sqlite"); } # script_snappymail_php_vars(&domain) # Returns an array of extra PHP variables needed for this script sub script_snappymail_php_vars { return ([ 'memory_limit', '64M', '+' ], [ 'max_execution_time', 300, '+' ], [ 'file_uploads', 'On' ], [ 'upload_max_filesize', '25M', '+' ], [ 'post_max_size', '25M', '+' ], [ 'session.auto_start', 'Off' ], [ 'mbstring.func_overload', 'Off' ]); } sub script_snappymail_php_vers { return ( 7 ); } sub script_snappymail_release { return 3; # For folders path fix } sub script_snappymail_php_fullver { return "7.4"; } # script_snappymail_params(&domain, version, &upgrade-info) # Returns HTML for table rows for options for installing PHP-NUKE sub script_snappymail_params { local ($d, $ver, $upgrade) = @_; local $rv; local $hdir = &public_html_dir($d, 1); if ($upgrade) { # Options are fixed when upgrading local ($dbtype, $dbname) = split(/_/, $upgrade->{'opts'}->{'db'}, 2); $rv .= &ui_table_row("Database for SnappyMail preferences", $dbname); local $dir = $upgrade->{'opts'}->{'dir'}; $dir =~ s/^$d->{'home'}\///; $rv .= &ui_table_row("Install directory", $dir); } else { # Show editable install options local @dbs = &domain_databases($d, [ "mysql", "postgres", "sqlite" ]); $rv .= &ui_table_row("Database for SnappyMail preferences", &ui_database_select("db", undef, \@dbs, $d, "snappymail")); $rv .= &ui_table_row("Install sub-directory under $hdir", &ui_opt_textbox("dir", &substitute_scriptname_template("snappymail", $d), 30, "At top level")); } return $rv; } # script_snappymail_parse(&domain, version, &in, &upgrade-info) # Returns either a hash ref of parsed options, or an error string sub script_snappymail_parse { local ($d, $ver, $in, $upgrade) = @_; if ($upgrade) { # Options are always the same return $upgrade->{'opts'}; } else { local $hdir = &public_html_dir($d, 0); $in{'dir_def'} || $in{'dir'} =~ /\S/ && $in{'dir'} !~ /\.\./ || return "Missing or invalid installation directory"; local $dir = $in{'dir_def'} ? $hdir : "$hdir/$in{'dir'}"; local ($newdb) = ($in->{'db'} =~ s/^\*//); return { 'db' => $in->{'db'}, 'newdb' => $newdb, 'dir' => $dir, 'path' => $in{'dir_def'} ? "/" : "/$in{'dir'}", }; } } # script_snappymail_check(&domain, version, &opts, &upgrade-info) # Returns an error message if a required option is missing or invalid sub script_snappymail_check { local ($d, $ver, $opts, $upgrade) = @_; $opts->{'dir'} =~ /^\// || return "Missing or invalid install directory"; $opts->{'db'} || return "Missing database"; if (-r "$opts->{'dir'}/config/db.inc.php") { return "SnappyMail appears to be already installed in the selected directory"; } local ($dbtype, $dbname) = split(/_/, $opts->{'db'}, 2); local $clash = &find_database_table($dbtype, $dbname, "system|filestore|contacts|users"); $clash && return "SnappyMail appears to be already using the selected database (table $clash)"; return undef; } # script_snappymail_files(&domain, version, &opts, &upgrade-info) # Returns a list of files needed by SnappyMail, each of which is a hash ref # containing a name, filename and URL sub script_snappymail_files { local ($d, $ver, $opts, $upgrade) = @_; local @files = ( { 'name' => "source", 'file' => "snappymail-$ver.tar.gz", 'url' => "https://github.com/the-djmaze/snappymail/releases/download/v${ver}/snappymail-${ver}.tar.gz" }, ); return @files; } sub script_snappymail_commands { return ("tar", "gunzip"); } # script_snappymail_install(&domain, version, &opts, &files, &upgrade-info) # Actually installs SnappyMail, and returns either 1 and an informational # message, or 0 and an error sub script_snappymail_install { local ($d, $version, $opts, $files, $upgrade) = @_; local ($out, $ex); # Create and get DB if ($opts->{'newdb'} && !$upgrade) { local $err = &create_script_database($d, $opts->{'db'}); return (0, "Database creation failed : $err") if ($err); } local ($dbtype, $dbname) = split(/_/, $opts->{'db'}, 2); local $dbuser = $dbtype eq "mysql" ? &mysql_user($d) : &postgres_user($d); local $dbpass = $dbtype eq "mysql" ? &mysql_pass($d) : &postgres_pass($d, 1); local $dbphptype = $dbtype eq "mysql" ? "mysql" : "psql"; local $dbhost = &get_database_host($dbtype, $d); local $dberr = &check_script_db_connection($dbtype, $dbname, $dbuser, $dbpass); return (0, "Database connection failed : $dberr") if ($dberr); # Extract tar file to temp dir and copy to target local $temp = &transname(); local $verdir = $ver; $verdir =~ s/-complete$//; local $err = &extract_script_archive($files->{'source'}, $temp, $d, $opts->{'dir'}, "snappymail-$verdir"); $err && return (0, "Failed to extract source : $err"); if (!$upgrade) { # Fix up the DB config file local $dbcfileorig = "$opts->{'dir'}/config/db.inc.php.dist"; local $dbcfile = "$opts->{'dir'}/config/db.inc.php"; if (-r $dbcfileorig) { ©_source_dest_as_domain_user($d, $dbcfileorig, $dbcfile); local $lref = &read_file_lines_as_domain_user($d, $dbcfile); foreach my $l (@$lref) { if ($l =~ /^\$rcmail_config\['db_dsnw'\]\s+=/) { $l = "\$rcmail_config['db_dsnw'] = 'mysql://$dbuser:". &php_quotemeta($dbpass, 1). "\@$dbhost/$dbname';"; } elsif ($l =~ /^\$rcmail_config\['db_backend'\]\s+=/) { $l = "\$rcmail_config['db_backend'] = 'db';"; } } &flush_file_lines_as_domain_user($d, $dbcfile); } # Figure out folder names local %fmap; $fmap{'drafts'} = $config{'drafts_folder'} || 'drafts'; $fmap{'sent'} = $config{'sent_folder'} || 'sent'; $fmap{'trash'} = $config{'trash_folder'} || 'sent'; local ($sdmode, $sdpath) = &get_domain_spam_delivery($d); if (($sdmode == 6 || $sdmode == 4) && $sdpath) { $fmap{'junk'} = $sdpath; } elsif ($sdmode == 1 && $sdpath =~ /^Maildir\/\.?(\S+)\/$/) { $fmap{'junk'} = $1; } # Fix up the main config file local $mcfileorig = "$opts->{'dir'}/config/main.inc.php.dist"; local $mcfile = "$opts->{'dir'}/config/main.inc.php"; if (!-r $mcfileorig) { $mcfileorig = "$opts->{'dir'}/config/config.inc.php.sample"; $mcfile = "$opts->{'dir'}/config/config.inc.php"; } ©_source_dest_as_domain_user($d, $mcfileorig, $mcfile); local $lref = &read_file_lines_as_domain_user($d, $mcfile); local $vuf = &get_mail_virtusertable(); local $added_vuf = 0; foreach my $l (@$lref) { if ($l =~ /^\$(rcmail_config|config)\['enable_caching'\]\s+=/) { $l = "\$${1}['enable_caching'] = FALSE;"; } if ($l =~ /^\$(rcmail_config|config)\['default_host'\]\s+=/) { $l = "\$${1}['default_host'] = 'localhost';"; } if ($l =~ /^\$(rcmail_config|config)\['default_port'\]\s+=/) { $l = "\$${1}['default_port'] = 143;"; } if ($l =~ /^\$(rcmail_config|config)\['smtp_server'\]\s+=/) { $l = "\$${1}['smtp_server'] = 'localhost';"; } if ($l =~ /^\$(rcmail_config|config)\['smtp_port'\]\s+=/) { $l = "\$${1}['smtp_port'] = 25;"; } if ($l =~ /^\$(rcmail_config|config)\['smtp_user'\]\s+=/) { $l = "\$${1}['smtp_user'] = '%u';"; } if ($l =~ /^\$(rcmail_config|config)\['smtp_pass'\]\s+=/) { $l = "\$${1}['smtp_pass'] = '%p';"; } if ($l =~ /^\$(rcmail_config|config)\['mail_domain'\]\s+=/) { $l = "\$${1}['mail_domain'] = '$d->{'dom'}';"; } if ($l =~ /^\$(rcmail_config|config)\['virtuser_file'\]\s+=/ && $vuf) { $added_vuf = 1; $l = "\$${1}['virtuser_file'] = '$vuf';"; } if ($l =~ /^\$(rcmail_config|config)\['plugins'\]\s+=\s+array\(\s*$/) { $l = "\$${1}['plugins'] = array('virtuser_file',"; } elsif ($l =~ /^\$(rcmail_config|config)\['plugins'\]\s+=/) { $l = "\$${1}['plugins'] = array('virtuser_file');"; } if ($l =~ /^\$(rcmail_config|config)\['db_dsnw'\]\s+=/) { $l = "\$${1}['db_dsnw'] = 'mysql://$dbuser:". &php_quotemeta($dbpass, 1)."\@$dbhost/$dbname';"; } if ($l =~ /^\$(rcmail_config|config)\['(\S+)_mbox'\]\s+=/ && $fmap{$2} && $fmap{$2} ne "*") { $l = "\$${1}['${2}_mbox'] = '$fmap{$2}';"; } } if (!$added_vuf && $vuf) { # Need to add virtuser_file directive, as no default exists push(@$lref, "\$rcmail_config['virtuser_file'] = '$vuf';"); push(@$lref, "\$config['virtuser_file'] = '$vuf';"); } &flush_file_lines_as_domain_user($d, $mcfile); # Run SQL setup script &require_mysql(); local $sqlfile; if ($dbtype eq "mysql") { $sqlfile = "$opts->{'dir'}/SQL/mysql.initial.sql"; } else { $sqlfile = "$opts->{'dir'}/SQL/postgres.initial.sql"; } local ($ex, $out) = &mysql::execute_sql_file($dbname, $sqlfile, $dbuser, $dbpass); $ex && return (-1, "Failed to run database setup script : ". "$out."); } else { # Create script of upgrade SQL to run, by extracting SQL from the old # version onwards from mysql.update.sql &require_mysql(); local $sqltemp = &transname(); &open_tempfile(SQLTEMP, ">$sqltemp", 0, 1); open(SQLIN, "<$opts->{'dir'}/SQL/mysql.update.sql"); local $foundver = 0; while() { if (/Updates\s+from\s+version\s+(\S+)/ && &compare_versions("$1", $upgrade->{'version'}) >= 0) { $foundver = 1; } if ($foundver) { &print_tempfile(SQLTEMP, $_); } } close(SQLIN); &close_tempfile(SQLTEMP); if ($foundver) { local ($ex, $out) = &mysql::execute_sql_file($dbname, $sqltemp, $dbuser, $dbpass); $ex && return (-1, "Failed to run database date script : ". "$out."); } &unlink_file($sqltemp); } # Return a URL for the user local $url = &script_path_url($d, $opts); local $rp = $opts->{'dir'}; $rp =~ s/^$d->{'home'}\///; return (1, "SnappyMail installation complete. It can be accessed at $url.", "Under $rp using $dbphptype database $dbname", $url); } # script_wordpress_db_conn_desc() # Returns a list of options for config file to update sub script_snappymail_db_conn_desc { my $conn_desc = { 'replace' => [ '\$(rcmail_config|config)\[[\'"]db_dsnw[\'"]\]\s*=\s*' => '\'$$sdbtype://$$sdbuser:$$sdbpass@$$sdbhost/$$sdbname\';' ], 'func' => 'php_quotemeta', 'func_params' => 1, 'multi' => 1, }; my $db_conn_desc = { 'config/config.inc.php' => { 'dbtype' => $conn_desc, 'dbuser' => $conn_desc, 'dbpass' => $conn_desc, 'dbhost' => $conn_desc, 'dbname' => $conn_desc, } }; return $db_conn_desc; } # script_snappymail_uninstall(&domain, version, &opts) # Un-installs a SnappyMail installation, by deleting the directory and database. # Returns 1 on success and a message, or 0 on failure and an error sub script_snappymail_uninstall { local ($d, $version, $opts) = @_; # Remove snappymail tables from the database &cleanup_script_database($d, $opts->{'db'}, "(.*)"); # Take out the DB if ($opts->{'newdb'}) { &delete_script_database($d, $opts->{'db'}); } # Remove the contents of the target directory local $derr = &delete_script_install_directory($d, $opts); return (0, $derr) if ($derr); return (1, "SnappyMail directory and tables deleted."); } # script_snappymail_latest(version) # Returns a URL and regular expression or callback func to get the version sub script_snappymail_latest { local ($ver) = @_; return ( "https://snappymail.eu/download/", "snappymail-([0-9\\.]+).tar.gz" ); } sub script_snappymail_site { return 'https://snappymail.eu/'; } sub script_snappymail_gpl { return 1; } 1;