]> www.wagner.pp.ru Git - oss/stilllife.git/blobdiff - forum/forum
newtopic operation somewhat works
[oss/stilllife.git] / forum / forum
index 989c5bc173ed374e8d975effa24c11eb61d4d49a..5ece800ea5750a442beddde87169e3247657a177 100755 (executable)
@@ -19,6 +19,9 @@ use HTML::TreeBuilder;
 use Storable qw(freeze thaw);
 use Date::Parse;
 use Email::Valid;
+use Image::Size;
+use HTML::BBReverse;
+use POSIX;
 use LWP::UserAgent;
 use Net::OpenID::Consumer;
 #
@@ -57,7 +60,7 @@ my %permissions = (
        profile => "normal",
        setrights => "admin",
 );     
-
+our $path_translated; # Untainted value of PATH_TRANSLATED env var
 my $cgi = new CGI;
 print STDERR "--------------------\n";
 my $forum=get_forum_config();
@@ -141,14 +144,15 @@ sub dir2url {
        return $prefix.substr($dir,length($root));
 }
 #
-# Поиск файла .forum вверх по дереву от $ENV{PATH_TRANSLATED}  
+# Поиск файла .forum вверх по дереву от $path_translated  
 # Значение PATH_TRANSLATED считаем безопасным - наш web-сервер нам не
 # враг.
 # Возвращает список имя,значение, имя, значение который прививается в
 # хэш
 
 sub get_forum_config {
-       my @path=split("/",$1) if $ENV{PATH_TRANSLATED}=~/^(\S+)$/;
+       $path_translated = $1 if $ENV{PATH_TRANSLATED}=~/^(\S+)$/;
+       my @path=split("/",$path_translated);
        while (@path>1) {
                if (-r (my $config=join("/",@path,".forum")) ) {
                        open F,"<",$config;
@@ -183,7 +187,6 @@ sub get_forum_config {
 
                        }       
                        $config{"userurl"} = dir2url($cgi,$config{"userdir"});
-
                        #
                        # Если нет ссылки в конфиге на файл паролей или он не 
                        # существует, выдаем ошибку. С офоромлением, так как шаблоны
@@ -200,6 +203,7 @@ sub get_forum_config {
                        $config{"authperiod"}="+1M" if (! exists $config{"authperiod"}); 
                        $config{"renewtime"} = "86000" if (!exists $config{"renewtime"});
                        $config{"replies_per_page"} = 50 if (!exists $config{"replies_per_page"});
+                       $config{"indexfile"} = "index.html" if (!exists $config{"indexfile"});
                        return \%config;
                }
                pop @path;
@@ -245,17 +249,6 @@ sub show_error {
        exit;
 }      
 
-sub gettemplate {
-       my ($forum, $template,$url) = @_;
-       my $filename=$forum->{"templates"}."/$template.html";
-       if (! -r $filename) {
-               show_error($forum,"Нет шаблона $template");
-               exit;
-       }
-       my $tree = HTML::TreeBuilder->new_from_file($filename);
-       fix_forum_links($forum,$tree,$url);
-       return $tree;
-}      
 #
 # Вывод шаблона формы. В шаблоне должна присутстовать форма с  
 # именем, совпадающим с именем form. Если в $cgi есть параметры, имена
@@ -329,12 +322,12 @@ sub show_template {
                                } else {        
                                $element->attr("value",$cgi->param($name));
                                }
-                       } elsif ($f->tag eq "textarea") {
-                               $f->delete_content;
-                               $f->push_content($cgi->param("name"));
-                       } elsif ($f->tag eq "select") {
-                               for my $option ($f->find_by_tag_name("option")) {
-                                       if (grep($option->attr("value") eq $_, $cgi-param("name"))) {
+                       } elsif ($element->tag eq "textarea") {
+                               $element->delete_content;
+                               $element->push_content($cgi->param($name));
+                       } elsif ($element->tag eq "select") {
+                               for my $option ($element->find_by_tag_name("option")) {
+                                       if (grep($option->attr("value") eq $_, $cgi->param($name))) {
                                                $option->attr("selected","");
                                        } else {        
                                                $option->attr("selected",undef);
@@ -345,7 +338,7 @@ sub show_template {
                }
 
        }
-       $f->attr("type","POST");
+       $f->attr("method","POST");
        for my $required ($form,"returnto") {
                if (!$substituted{$required}) {
                        my $element = new HTML::Element('input',
@@ -415,45 +408,48 @@ sub fix_forum_links {
 
 sub substitute_user_info {
 
-my ($tree,$forum) = @_;
-my %userinfo = %{$forum->{"authenticated"}};
+my ($tree,$forum,$user) = @_;
+my %userinfo;
+if (defined $user) {
+       my %users;
+       dbmopen %users,datafile($forum,"passwd"),0644;
+       if (!$users{$user}) {
+               show_error($forum,"Неизвестный пользователь $user");
+       }
+       my $record = thaw($users{$user});
+       %userinfo = %$record;
+       $userinfo{"user"} = $user;
+} else {
+       # Если не сказано, какой юзер, то текущий.
+       %userinfo = %{$forum->{"authenticated"}}  
+}
 
 #
 # Специально обрабатываем поля user (должна быть ссылка) и avatar  
 # (должен быть img).
-my @userlink = $tree->look_down("_tag"=>"a","class"=>"author");
-if (@userlink) {
        my $userpage;
-       if ($userinfo{"user"}=~/^http:/) {
-               $userpage = $userinfo{"user"};
+       if ($userinfo{"openiduser"}) {
+               $userpage = "http://".$userinfo{"user"};
        } else {
                $userpage =
                $cgi->url(-absolute=>1).$forum->{"userurl"}."/".$cgi->escape($userinfo{"user"});
        }       
-       for my $element (@userlink) {
-               $element->attr(href=>$userpage);
-               $element->delete_content();
-               $element->push_content($userinfo{"user"});
-       }
-}      
-delete $userinfo{"userpage"};
-delete $userinfo{"user"};
-my $avatar = $tree->look_down("_tag"=>"img","class"=>"avatar");
-if ($avatar) {
-       $avatar->attr(src=>$userinfo{"avatar"});
-}
-delete $userinfo{"avatar"};
+       substinfo($tree,["_tag"=>"a","class"=>"author"],
+        href=>$userpage,_content=>$userinfo{"user"});
+       delete $userinfo{"user"};
+       substinfo($tree,["_tag"=>"img","class"=>"avatar"],
+       src=>$userinfo{"avatar"}||$forum->{templatesurl}."/1x1.gif");
+       delete $userinfo{"avatar"};
 
-while (my ($field,$value)=each %userinfo) {
-       my $element = $tree->look_down("class","a".$field);
-       if ($element) {
-               $element->delete_content();
-               # 
-               # FixME - allow HTML in author attributes
-               $element->push_content($value);
+       for my $element ( $tree->look_down("class",qr/^ap-/)) {
+               my $field=$1 if $element->attr("class")=~/^ap-(.*)$/;   
+               $element->delete_content();
+               $element->push_content(str2tree($userinfo{$field})) 
+                               if $userinfo{$field};
+               $element->attr(href=>"mailto:$userinfo{$field}") 
+                       if ($element->tag eq "a" && $field eq "email");
        }
 
-}
 
 }
 #
@@ -490,8 +486,7 @@ sub authorize_user  {
                                                }
                                                print STDERR "user $user restored session $session\n";
                                                $forum->{"authenticated"}=$userinfo;
-                                               print STDERR "authorize_user:
-                                               ",$forum->{authenticated}{user},
+                                               print STDERR "authorize_user: ",$forum->{authenticated}{user},
                                                $forum->{authenticated},"\n";
                                        }       
                                        dbmclose %userbase; 
@@ -706,6 +701,12 @@ sub register {
        newsession(undef,$forum,$user);
        forum_redirect($cgi,$forum,$returnto) 
 }      
+sub clear_user_cookies {
+       my ($cgi,$forum) = @_;
+       $forum->{cookies}=[ $cgi->cookie(-name=>"sluser", -value=>"0",
+       -expires=>"-1m"),$cgi->cookie(-name=>"slsession", -value=>"0",
+                       -expires => "-1m")];
+}                      
 #
 # Обработчик формы логина. Сводится к вызову функции authenticate,
 # поскольку мы поддерживаем логин одновременный с отправкой реплики. 
@@ -718,12 +719,6 @@ sub login {
                show_template(@_);
        }       
 }      
-sub clear_user_cookies {
-       my ($cgi,$forum) = @_;
-       $forum->{cookies}=[ $cgi->cookie(-name=>"sluser", -value=>"0",
-       -expires=>"-1m"),$cgi->cookie(-name=>"slsession", -value=>"0",
-                       -expires => "-1m")];
-}                      
 #
 # Обработчик формы logout. В отличие от большинства обработчиков форм,
 # поддерживает обработку методом GET
@@ -770,9 +765,9 @@ sub reply {
        #
        # Находим файл дискуссии, в который надо поместить реплику
        #
-       my ($tree,$lockfd)=gettree($ENV{'PATH_TRANSLATED'}); 
-       my $messagetpl = $tree->look_down(class=>"message");
-       if (!$messagetpl) {
+       my ($tree,$lockfd)=gettree($path_translated); 
+       my $newmsg = newlistelement($tree,"message","messagelist");
+       if (!$newmsg) {
                show_error($forum,"Шаблон темы не содержит элемента с классом
                message");
                exit;
@@ -787,24 +782,28 @@ sub reply {
        #
        # Сохраняем приаттаченные картинки, если есть.
        #
-       my $dir = $ENV{PATH_TRANSLATED};
+       my $dir = $path_translated;
+
        $dir=~ s/[^\/]+$// if (-f $dir);
        my %attached;
-       for (my $i=1;defined $cgi->param("image$i"); $i++) {
+       for (my $i=1;$cgi->param("image$i"); $i++) {
                my $userpath=$cgi->param("image$i");
                my $filename=lc($1) if $userpath =~ /([^\/\\]+)$/;
-               attached{$filename} = $id."_".$filename;
+               $attached{$filename} = $id."_".$filename;
                my $in = $cgi->upload("image$i");
+               if (!$in) {
+                       show_error($forum,"Ошибка при загрузке картинки $filename");
+                       exit;
+               }       
                my $out;
                open $out,">$dir/$attached{$filename}";
                binmode $out,":bytes";
-               local $_=undef;
+               local $/=undef;
                my $data = <$in>;
                print $out $data;
                close $in;
                close $out;
        }
-
        #
        # Преобразуем текст записи в html и чистим его
        #
@@ -814,8 +813,8 @@ sub reply {
        # имена, под которыми мы их сохранили.
        #
        for my $image ($txtree->find_by_tag_name("img")) {
-               my $file;
-               if ( exists $attached{$file=lc($image->attr("src"))}) {
+               my $file=lc($image->attr("src"));
+               if ( exists $attached{$file}) {
                        $image->attr("src" => $attached{$file});
                        my ($width,$height) = imgsize($dir ."/".$attached{$file});              
                        $image->attr("width" =>$width);
@@ -823,20 +822,10 @@ sub reply {
                }       
        }       
        #
-       # Копируем элемент с классом message
-       #
-       my $newmsg = $messagetpl->clone;
-       my $parent = $messagetpl->parent;
-       $parent->push_content($newmsg);
-       #
        # Подставляем данные сообщения 
        #
        $newmsg->attr("id"=>$id);
-       if (my $subj=$newmsg->look_down("class"=>"subject") &&
-               $cgi->param("subject")) {
-               $subj->delete_content;
-               $subj->push_content($cgi->param("subject"));
-       }
+       substinfo($newmsg,[class=>"subject"],_content=>$cgi->param("subject"));
        my $textnode=$newmsg->look_down("class"=>"mtext");
        if (!$textnode) {
                show_error($forum,"В шаблоне реплики нет места для текста"); 
@@ -853,71 +842,142 @@ sub reply {
        #
        my $editform=$newmsg->look_down(_tag=>"form","class"=>"msginfo");
        if ($editform) {
-               my $idfield = $editform->look_down(_tag=>"input","name"=>"id");
-               if (!$idfield) {
-                       show_error($forum,"В форме управления сообщением нет поля
-                       id");
-               }
-               $idfield->attr("value" => $id);
-               my $authorfield = $editform->look_down(_tag=>"input","name"=>"author");
-               if (!$authorfield) {
-                       show_error($forum,"В форме управления сообщением нет поля
-                       id");
-               }
-               $authorfield->attr("value"=>$forum->{authenticated}{user});
+               substinfo($editform,[_tag=>"input",name=>"id"],value=>$id) ||
+                       show_error($forum,"В форме управления сообщением нет поля id");
+               substinfo($editform,[_tag=>"input",name=>"author"],value=>
+                       $forum->{authenticated}{user}) ||
+                       show_error($forum,"В форме управления сообщением нет поля author");
        }
        # Подставляем mdate
-       my $date = $newmsg->look_down("class"=>"mdate");
-       if ($date) {
-               $date->delete_content;
-               $date->push_content(strftime("%d.%m.%Y %H:%M",localtime()));
-
-       }       
+       substinfo($newmsg,["class"=>"mdate"],
+               _content =>strftime("%d.%m.%Y %H:%M",localtime()));
        # Подставляем mreply
-       my $reply_link = $newmsg->look_down(_tag=>"a","class"=>"mreply");
-       $reply_link->attr("href"=> $cgi->url(-absolute=>1,-path_info=>1).
-               "?reply=1&id=$id") if ($reply_link);
+       substinfo($newmsg,[_tag=>"a","class"=>"mreply"],"href" =>
+        $cgi->url(-absolute=>1,-path_info=>1)."?reply=1&id=$id");
        # Подставляем manchor
-       my $anchor = $newmsg->look_down(_tag=>"a","class"=>"manchor");
-       if (! $anchor) {
-               show_error($forum,"В шаблоне сообщения отсутствует якорь для
-               ссылок на него");
-               exit;
-       }       
-       $anchor->attr(href=>undef);
-       $anchor->attr(name=>"#$id");
+       substinfo($newmsg,[_tag=>"a","class"=>"manchor"],
+               "name"=>"#$id","href"=>undef) or
+               show_error($forum,"В шаблоне сообщения отсутствует якорь для ссылок на него");
        # подставляем mlink
-       my $link = $newmsg->look_down(_tag=>"a","class"=>"mlink");
-       $link->attr(href=>$cgi->path_info."#id");
+       substinfo($newmsg,[_tag=>"a","class"=>"mlink"],
+               href=>$cgi->path_info."#id");
        # подставляем mparent
        my $parent_id=$cgi->param("id");
-       my $parent_link=$newmsg->lookdown(_tag => "a",class=>"mparent");
-       if ($parent_link) {
-               if ($parent_id) {
-                       $parent_link->attr("href"=>$cgi->path_info."#$parent_id");
-               } else {
-                       # Если parent_id отсутствует, т.е. это начало нового треда
-                       # просто делаем ссылку невидимой.
-                       $parent_link->delete_content();
-               }
+       if ($parent_id) {
+               substinfo($newmsg,[_tag => "a",class=>"mparent"], 
+                       "href"=>$cgi->path_info."#$parent_id",style=>undef);
+       } else {
+               substinfo($newmsg,[_tag => "a",class=>"mparent"], 
+                       style=>"display: none;");
        }       
 
-       #
-       # Проверяем видимость списка сообщений 
-       #
-       my $msglist = $tree->look_down("class"=>"messagelist");
-       if ($msglist) {
-               my $style = $msglist->attr("style");
-               $msglist->attr("style",$style) if $style =~ s/display: none;//;
-       }       
        #
        # Делаем Уфф и сохраняем то, что получилось 
        #
-       savetree($ENV{PATH_TRANSLATED},$tree,$lockfd);
+       savetree($path_translated,$tree,$lockfd);
+       record_statistics($forum,"message"),
        forum_redirect($cgi,$forum);
         
 }      
 #
+# Обработка операции создания новой темы. 
+#
+
+sub new_topic {
+       my ($form,$cgi,$forum) = @_;
+       #
+       # Проверяем корректность urlname и прочих полей
+       #
+       my $urlname;
+       if (!$cgi->param("urlname")) {
+               $urlname = get_uid($forum);
+       } else {        
+               $urlname=$1 if $cgi->param("urlname") =~ /^([-\w]+)$/;
+               form_error($form,$cgi,$forum,"Некорректные символы в urlname.
+               Допустимы только латинские буквы, цифры и минус") unless $urlname; 
+       }
+       if (!-d $path_translated) {
+               show_error($forum,"Операция $form может быть вызвана только со
+               страницы форума");
+       }       
+       my $filename = "$path_translated/$urlname.html";
+       if (-f $filename) {
+               form_error($form,$cgi,$forum,"Тема с urlname $urlname уже
+               существует");
+       }       
+       if (!$cgi->param("title")) {
+               form_error($form,$cgi,$forum,"Тема должна иметь непустое название");
+       }       
+       #
+       # Создаем собственно тему
+       #
+       my $tree = gettemplate($forum,"topic",$cgi->path_info."/$urlname.html");
+    # Заполнить название и аннотацию 
+       my $abstract = input2tree($cgi,$forum,"abstract");
+       substinfo($tree,[_tag=>"meta","name"=>"description"],content=>$abstract->as_trimmed_text);
+       substinfo($tree,[_tag=>"title"],_content=>$cgi->param("title"));
+       my $subtree = $tree->look_down("class"=>"topic");
+       my $creation_time=strftime("%d.%m.%Y %H:%M",localtime());
+       if ($subtree) {
+               substinfo($subtree,["class"=>"title"],
+               _content=>$cgi->param("title"));
+               substinfo($subtree,["class"=>"date"],
+                       _content=>$creation_time);
+               # Вставляем в страницу КОПИЮ аннотации, поскольку аннотация
+               # нам еще понадобится в списке тем.
+               substinfo($subtree,["class"=>"abstract"],_content=>$abstract->clone);   
+               substitute_user_info($subtree,$forum);  
+       } else {
+               substinfo($tree,["class"=>"title"],
+               _content=>$cgi->param("title"));
+       }       
+       # Скрыть список сообщений.
+       hide_list($tree,"messagelist");
+       savetree($filename,$tree,undef);
+       #
+       # Добавляем элемент в список тем текущего форума
+       #
+       $tree->destroy;
+
+       my $lockfd;
+       ($tree,$lockfd)=gettree($path_translated."/".$forum->{"indexfile"});
+       my $newtopic = newlistelement($tree,"topic","topiclist");
+       substinfo($newtopic,[_tag=>"a","class"=>"title"],
+       _content=>$cgi->param("title"), href=>"$urlname.html");
+       substinfo($newtopic,["class"=>"date"], _content=>$creation_time);
+       substinfo($newtopic,["class"=>"abstract"],_content=>$abstract); 
+       substitute_user_info($newtopic,$forum); 
+       $newtopic->attr("id",$urlname);
+       my $controlform = $newtopic->look_down(_tag=>"form",class=>"topicinfo");
+       if ($controlform) {
+               $controlform->attr("action"=>$cgi->url(-absolute=>1,-path_info=>1).
+               "/$urlname.html");
+               substinfo($controlform,[_tag=>"input",name=>"author"],value=>
+                       $forum->{authenticated}{user});
+       }               
+       savetree($path_translated."/".$forum->{"indexfile"},$tree,$lockfd);
+       record_statistics($forum,"topic");
+       forum_redirect($cgi,$forum,$cgi->path_info."/$urlname.html");
+}
+#---------------------------------------------------------- 
+# База пользователей и права доступа
+#----------------------------------------------------------
+#
+# Записывает в базу данных пользователей, сколько каких объектов 
+# создал текущий пользователь
+#
+sub record_statistics {
+       my ($forum,$type) = @_;
+       my $user = $forum->{authenticated}{user};
+       my %base;
+       dbmopen %base,datafile($forum,"passwd"),0664;
+       my $userinfo = thaw($base{$user});
+       $userinfo->{$type."s"}++;
+       $userinfo->{"last_$type"}=time;
+       $base{$user} = freeze($userinfo);
+       dbmclose %base;
+}
+#
 # читает файлы прав доступа в дереве форума, и возвращает
 # статус текущего пользователя (undef - аноним, banned, normal,
 # moderator или admin
@@ -964,6 +1024,11 @@ sub getrights {
 }              
 
 
+
+#------------------------------------------------------------------
+# Работа с файлами и идентификторами
+#------------------------------------------------------------------
+
 #
 # Залочить файл и получить его распрасенное представление.
 # Возвращает пару ($tree,$lockfd)
@@ -982,7 +1047,7 @@ sub gettree {
 #
 
 sub savetree {
-       my ($filename,$tree,$lockfd) = shift;
+       my ($filename,$tree,$lockfd) = @_;
        my $f;
        open $f,">",$filename . ".new" or return undef;
        print $f $tree->as_HTML("<>&");
@@ -992,7 +1057,22 @@ sub savetree {
        rename $filename.".new",$filename;
        close $lockfd if defined($lockfd);
 }      
+#
+# Читает шаблон и подготавливает его к размещению по указанной URL.
+# Если url не указана, считается что шаблон будет показан как результат
+# текущего http-запроса.
 
+sub gettemplate {
+       my ($forum, $template,$url) = @_;
+       my $filename=$forum->{"templates"}."/$template.html";
+       if (! -r $filename) {
+               show_error($forum,"Нет шаблона $template");
+               exit;
+       }
+       my $tree = HTML::TreeBuilder->new_from_file($filename);
+       fix_forum_links($forum,$tree,$url);
+       return $tree;
+}      
 
 
 #
@@ -1001,14 +1081,15 @@ sub savetree {
 sub get_uid {
        my $forum = shift;
        my $f;
-       open $f,"<+",datafile($forum,"sequence");
+       open $f,"+<",datafile($forum,"sequence") or 
        flock $f,LOCK_EX;
        my $id=<$f> || "0";
        $id++;
        seek $f,0,0;
        printf $f "%8s\n",$id;
        close $f;
-       return sprintf ("%08s",$id);
+       $id=~/(\d+)/;
+       return sprintf ("%08s",$1);
 }
 # --------------------------------------------------------------------
 #  OpenID registration
@@ -1104,18 +1185,14 @@ sub input2tree {
        my ($cgi,$forum,$field_name) = @_;
        my $format = $cgi->param($field_name."_format");
        my $text = $cgi->param($field_name);
-
        if ($format eq "bbcode") {
                my $parser = HTML::BBReverse->new(); 
                $text="<div class=\"bbcode\">".$parser->parse($text)."</div>";
-
        } elsif ($format eq "text") {
                $text=~s/\r?\n\r?\n/<\/p><p class=\"text\">/;
                $text=~s/\r?\n/<br>/;
-               $text = "<p class=\"text\">".$text."</p>";
-       } else {
-               $text="<div>".$text."</div>";
-       }       
+               $text = "<div><p class=\"text\">".$text."</p></div>";
+       } 
        my $txtree = str2tree($text);
        for my $badtag
        ("script","style","head","html","object","embed","iframe","frameset","frame",
@@ -1134,13 +1211,114 @@ sub str2tree {
        my ($data)=@_;
        my $tree = HTML::TreeBuilder->new();
        # Set parser options here
-       $tree->parse($data);
+       $tree->parse("<html><body><div>$data</div></body></html>");
        $tree->eof;
-       return $tree;
-
+       my $element=$tree->find("body");
+       while (($element =($element->content_list)[0])->tag ne "div") {
+       }
+       $element->detach;
+       $tree->destroy;
+       return $element;
 }      
 
 sub tree2str {
        my ($tree)=@_;
        return $tree->as_HTML("<>&");
 }
+
+#------------------------------------------------------------------------
+# Подстановка в дереве
+#------------------------------------------------------------------------
+# Находит 
+# элемент указанного класса и удаляет display: none из его атрибута
+# style. Возвращает 1, если элемент был раскрыт, и 0, если он и до этого 
+# был видимым.
+sub unhide_list {
+       my ($tree,$class) = @_;
+       my $msglist = $tree->look_down("class"=>$class);
+       if ($msglist) {
+               my $style = $msglist->attr("style");
+               if ($style && $style =~ s/display: none;//) {
+                       $msglist->attr("style",$style);
+                       return 1;
+               } else {
+                       return 0;
+               }       
+       } 
+}      
+#
+# Находит первый элемент указанного класса, и приписывает ему display:
+# none в style.
+#
+sub hide_list {
+       my ($tree,$class)=@_;
+       my $msglist = $tree->look_down("class"=>$class);
+       return undef unless $msglist;
+       if (!$msglist->attr("style")) {
+               $msglist->attr("style","display: none;");
+       } else {
+               my $style = $msglist->attr("style");
+               unless ($style=~ s/\bdisplay:\s+\w+\s*;/display: none;/) {
+                       $style .= "display: none;";
+               } 
+               $msglist->attr("style",$style);
+       }       
+       return 1;
+}      
+#
+# Найти все элементы, удоволетворяющие заданному критерию и подставить в
+# них указанные атрибуты
+# 
+# Параметры 1. Дерево (класса HTML::Element)
+# 2. Запрос - ссылка на список вида атрибут=>значение. 
+#    Этот список будет непосредственно передан в
+#    HTML::Element::look_down
+# 3. Далее пары имя-атрибута, значение. Если вместо имени атрибута
+#    использовать слово _content, заменено будет содержимое элемента.
+#    Значение для _content - ссылка на HTML::Element. Если там строка,
+#    она будет вставлена как одиночный текстовый узел.
+# 4. Возвращает число выполненных подстановок (0, если искомых элементов   
+#   не найдено.
+#
+sub substinfo {
+       my ($tree,$query,@attrs) = @_;
+       my $count;
+       foreach my $element ($tree->look_down(@$query)) {
+               $count ++;
+               while (@attrs) {
+                       my $attr = shift @attrs;
+                       my $value = shift @attrs;
+                       if ($attr eq "_content") {
+                               $element->delete_content;
+                               $element->push_content($value);
+                       } else {        
+                               $element->attr($attr,$value);
+                       }       
+               }       
+       }
+       return $count;  
+}
+#
+# newlistelement($tree,$elementclass,$listclass) 
+#
+# Если список с указанным классом скрыт, раскрывает его и возвращает 
+# (единственный) элемент 
+sub newlistelement {
+       my ($tree,$element,$list) =@_;
+       my $msglist = $tree->look_down("class"=>$list);
+       if ($msglist) {
+               my $style = $msglist->attr("style");
+               if ($style && $style =~ s/display: none;//) {
+                       $msglist->attr("style",$style);
+                       return $msglist->look_down(class=>$element);
+               } else {
+                       my $template = $msglist->look_down("class"=>$element);
+                       return undef unless $template;
+                       my $newitem=$template->clone;
+                       $template->parent->push_content($newitem);
+                       return $newitem;
+               }
+       } else {
+               return undef;
+       }
+}