4 Plugin URI: http://f-droid.org/repository
5 Description: An FDroid repository browser
6 Author: Ciaran Gultnieks
8 Author URI: http://ciarang.com
11 0.01 - 2010-12-04: Initial development version
15 include('android-permissions.php');
20 // Our text domain, for internationalisation
21 private $textdom='wp-fdroid';
27 // Add filters etc here!
28 add_shortcode('fdroidrepo',array($this, 'do_shortcode'));
29 add_filter('query_vars',array($this, 'queryvars'));
31 $this->site_path=getenv('DOCUMENT_ROOT');
32 wp_register_sidebar_widget('fdroid_latest', 'FDroid Latest', 'widget_fdroidlatest');
36 // Register additional query variables. (Handler for the 'query_vars' filter)
37 function queryvars($qvars) {
39 $qvars[]='fdcategory';
47 // Lazy initialise. All non-trivial members should call this before doing anything else.
50 load_plugin_textdomain($this->textdom, PLUGINDIR.'/'.dirname(plugin_basename(__FILE__)), dirname(plugin_basename(__FILE__)));
56 // Gets a required query parameter by name.
57 function getrequiredparam($name) {
59 if(!isset($wp_query->query_vars[$name]))
60 wp_die("Missing parameter ".$name,"Error");
61 return $wp_query->query_vars[$name];
64 // Handler for the 'fdroidrepo' shortcode.
65 // $attribs - shortcode attributes
66 // $content - optional content enclosed between the starting and
68 // Returns the generated content.
69 function do_shortcode($attribs,$content=null) {
70 global $wp_query,$wp_rewrite;
73 // Init local query vars
74 foreach($this->queryvars(array()) as $qv) {
75 if(array_key_exists($qv,$wp_query->query_vars)) {
76 $query_vars[$qv] = $wp_query->query_vars[$qv];
78 $query_vars[$qv] = null;
82 // Santiy check query vars
83 if(!isset($query_vars['fdpage']) || !is_numeric($query_vars['fdpage']) || $query_vars['fdpage'] <= 0) {
84 $query_vars['fdpage'] = 1;
89 if(isset($attribs['search']) && $query_vars['fdfilter']===null) {
90 $query_vars['fdfilter'] = '';
93 if($query_vars['fdcategory'] == 'All applications') {
94 unset($query_vars['fdcategory']);
97 if($query_vars['fdid']!==null) {
98 $out.=$this->get_app($query_vars);
100 if($query_vars['fdfilter'] !== null) {
101 $out.='<form name="searchform" action="" method="get">';
102 $out.='<p><input name="fdfilter" type="text" value="'.$query_vars['fdfilter'].'" size="30"> ';
103 $out.='<input type="submit" value="Search"></p>';
104 $out.=$this->makeformdata($query_vars);
105 $out.='</form>'."\n";
108 $out.=$this->get_apps($query_vars);
115 // Get a URL for a full description of a license, as given by one of our
116 // pre-defined license abbreviations. This is a temporary function, as this
117 // needs to be data-driven so the same information can be used by the client,
118 // the web site and the documentation.
119 function getlicenseurl($license) {
122 return 'http://www.gnu.org/licenses/license-list.html#X11License';
124 return 'http://www.gnu.org/licenses/license-list.html#ModifiedBSD';
126 return 'http://www.gnu.org/licenses/license-list.html#OriginalBSD';
129 return 'http://www.gnu.org/licenses/license-list.html#GNUGPL';
132 return 'http://www.gnu.org/licenses/license-list.html#GPLv2';
134 return 'http://www.gnu.org/licenses/license-list.html#LGPL';
136 return 'http://www.gnu.org/licenses/license-list.html#apache2';
142 function get_app($query_vars) {
143 global $permissions_data;
144 $permissions_object = new AndroidPermissions($this->site_path.'/wp-content/plugins/wp-fdroid/AndroidManifest.xml',
145 $this->site_path.'/wp-content/plugins/wp-fdroid/strings.xml',
146 sys_get_temp_dir().'/android-permissions.cache');
147 $permissions_data = $permissions_object->get_permissions_array();
150 $xml = simplexml_load_file($this->site_path.'/repo/index.xml');
151 foreach($xml->children() as $app) {
153 $attrs=$app->attributes();
154 if($attrs['id']==$query_vars['fdid']) {
156 foreach($app->children() as $el) {
157 switch($el->getName()) {
193 foreach($el->children() as $pel) {
194 switch($pel->getName()) {
196 $thisapk['version']=$pel;
199 $thisapk['vercode']=$pel;
202 $thisapk['apkname']=$pel;
205 $thisapk['srcname']=$pel;
208 $thisapk['hash']=$pel;
211 $thisapk['size']=$pel;
214 $thisapk['sdkver']=$pel;
217 $thisapk['permissions']=$pel;
226 // Generate app diff data
227 foreach(array_reverse($apks, true) as $key=>$apk) {
228 if(isset($previous)) {
230 $apks[$key]['diff']['size'] = $apk['size']-$previous['size'];
234 $permissions = explode(',',$apk['permissions']);
235 $permissionsPrevious = isset($previous['permissions'])?explode(',',$previous['permissions']):array();
236 $apks[$key]['diff']['permissions']['added'] = array_diff($permissions, $permissionsPrevious);
237 $apks[$key]['diff']['permissions']['removed'] = array_diff($permissionsPrevious, $permissions);
242 // Output app information
243 $out='<div id="appheader">';
244 $out.='<div style="float:left;padding-right:10px;"><img src="' . site_url() . '/repo/icons/'.$icon.'" width=48></div>';
245 $out.='<p><span style="font-size:20px">'.$name."</span>";
246 $out.="<br>".$summary."</p>";
249 $out.=str_replace('href="fdroid.app:', 'href="/repository/browse/?fdid=', $desc);
251 if(isset($antifeatures)) {
252 $antifeaturesArray = explode(',',$antifeatures);
253 foreach($antifeaturesArray as $antifeature) {
254 $antifeatureDesctiption = $this->get_antifeature_description($antifeature);
255 $out.='<p style="border:3px solid #CC0000;background-color:#FFDDDD;padding:5px;"><strong>'.$antifeatureDesctiption['name'].'</strong><br />';
256 $out.=$antifeatureDesctiption['description'].'</p>';
261 $licenseurl=$this->getlicenseurl($license);
262 $out.="<b>License:</b> ";
264 $out.='<a href="'.$licenseurl.'" target="_blank">';
269 if(isset($requirements)) {
270 $out.='<br /><b>Additional requirements:</b> '.$requirements;
276 $out.='<b>Website:</b> <a href="'.$web.'">'.$web.'</a><br />';
277 if(strlen($issues)>0)
278 $out.='<b>Issue Tracker:</b> <a href="'.$issues.'">'.$issues.'</a><br />';
279 if(strlen($source)>0)
280 $out.='<b>Source Code:</b> <a href="'.$source.'">'.$source.'</a><br />';
281 if($donate && strlen($donate)>0)
282 $out.='<b>Donate:</b> <a href="'.$donate.'">'.$donate.'</a><br />';
285 $out.='<script type="text/javascript">';
286 $out.='function showHidePermissions(id) {';
287 $out.=' if(document.getElementById(id).style.display==\'none\')';
288 $out.=' document.getElementById(id).style.display=\'block\';';
290 $out.=' document.getElementById(id).style.display=\'none\';';
291 $out.=' return false;';
295 $out.="<p><b>NOTE:</b> Although APK downloads are available below to give ";
296 $out.="you the choice, you should be aware that by installing that way you ";
297 $out.="will not receieve update notifications, and it's a less secure way ";
298 $out.="to download, especially if you are not currently using HTTPS. ";
299 $out.="We recommend that you install the F-Droid client and use that.</p>";
301 $out.="<h3>Packages</h3>";
303 foreach($apks as $apk) {
304 $first = $i+1==count($apks);
305 $out.="<p><b>Version ".$apk['version']."</b><br />";
307 // Is this source or binary?
308 $srcbuild = isset($apk['srcname']) && file_exists($this->site_path.'/repo/'.$apk['srcname']);
310 $out.="<p>This version is built and signed by ";
312 $out.="F-Droid, and guaranteed to correspond to the source tarball below.</p>";
314 $out.="the original developer.</p>";
316 $out.='<a href="https://f-droid.org/repo/'.$apk['apkname'].'">download apk</a> ';
317 $out.=$this->human_readable_size($apk['size']);
318 $diffSize = $apk['diff']['size'];
319 if(abs($diffSize) > 500) {
320 $out.=' <span style="color:#AAAAAA;">(';
321 $out.=$diffSize>0?'+':'';
322 $out.=$this->human_readable_size($diffSize, 1).')</span>';
325 $out.='<br /><a href="https://f-droid.org/repo/'.$apk['srcname'].'">source tarball</a> ';
326 $out.=$this->human_readable_size(filesize($this->site_path.'/repo/'.$apk['srcname']));
329 if(isset($apk['permissions'])) {
330 // Permissions diff link
331 if($first == false) {
332 $permissionsAddedCount = count($apk['diff']['permissions']['added']);
333 $permissionsRemovedCount = count($apk['diff']['permissions']['removed']);
334 $divIdDiff='permissionsDiff'.$i;
335 if($permissionsAddedCount || $permissionsRemovedCount) {
336 $out.='<br /><a href="javascript:void(0);" onClick="showHidePermissions(\''.$divIdDiff.'\');">permissions diff</a>';
337 $out.=' <span style="color:#AAAAAA;">(';
338 if($permissionsAddedCount)
339 $out.='+'.$permissionsAddedCount;
340 if($permissionsAddedCount && $permissionsRemovedCount)
342 if($permissionsRemovedCount)
343 $out.='-'.$permissionsRemovedCount;
348 $out.='<br /><span style="color:#999999;">no permission changes</span>';
352 // Permissions list link
353 $permissionsListString = $this->get_permission_list_string(explode(',',$apk['permissions']), $permissions_data, $summary);
355 $divStyleDisplay='block';
357 $divStyleDisplay='none';
358 $divId='permissions'.$i;
359 $out.='<br /><a href="javascript:void(0);" onClick="showHidePermissions(\''.$divId.'\');">view permissions</a>';
360 $out.=' <span style="color:#AAAAAA;">['.$summary.']</span>';
364 $out.='<div style="display:'.$divStyleDisplay.';" id="'.$divId.'">';
365 $out.=$permissionsListString;
370 $out.='<div style="display:'.$divStyleDisplay.';" id="'.$divIdDiff.'">';
371 $permissionsRemoved = $apk['diff']['permissions']['removed'];
372 usort($permissionsRemoved, "permissions_cmp");
375 if($permissionsAddedCount) {
376 $out.='<h5>ADDED</h5><br />';
377 $out.=$this->get_permission_list_string($apk['diff']['permissions']['added'], $permissions_data, $summary);
380 // Removed permissions
381 if($permissionsRemovedCount) {
382 $out.='<h5>REMOVED</h5><br />';
383 $out.=$this->get_permission_list_string($apk['diff']['permissions']['removed'], $permissions_data, $summary);
390 $out.='<br /><span style="color:#999999;">no extra permissions needed</span><br />';
397 $out.='<hr><p><a href="'.makelink($query_vars,array('fdid'=>null)).'">Index</a></p>';
402 return "<p>Application not found</p>";
405 private function get_permission_list_string($permissions, $permissions_data, &$summary) {
407 usort($permissions, "permissions_cmp");
408 $permission_group_last = '';
409 foreach($permissions as $permission) {
410 $permission_group = $permissions_data['permission'][$permission]['permissionGroup'];
411 if($permission_group != $permission_group_last) {
412 $permission_group_label = $permissions_data['permission-group'][$permission_group]['label'];
413 if($permission_group_label=='') $permission_group_label = 'Extra/Custom';
414 $out.='<strong>'.strtoupper($permission_group_label).'</strong><br/>';
415 $permission_group_last = $permission_group;
418 $out.=$this->get_permission_protection_level_icon($permissions_data['permission'][$permission]['protectionLevel']).' ';
419 $out.='<strong>'.$permissions_data['permission'][$permission]['label'].'</strong> [<code>'.$permission.'</code>]<br/>';
420 if($permissions_data['permission'][$permission]['description']) $out.=$permissions_data['permission'][$permission]['description'].'<br/>';
421 //$out.=$permissions_data['permission'][$permission]['comment'].'<br/>';
424 if(!isset($summaryCount[$permissions_data['permission'][$permission]['protectionLevel']]))
425 $summaryCount[$permissions_data['permission'][$permission]['protectionLevel']] = 0;
426 $summaryCount[$permissions_data['permission'][$permission]['protectionLevel']]++;
430 if(isset($summaryCount)) {
431 foreach($summaryCount as $protectionLevel => $count) {
432 $summary .= $this->get_permission_protection_level_icon($protectionLevel, 'regular').' '.$count;
436 $summary = substr($summary,0,-2);
441 private function get_permission_protection_level_icon($protection_level, $size='adjusted') {
443 if($protection_level=='dangerous') {
444 $iconString .= '<span style="color:#DD9900;';
445 if($size=='adjusted')
446 $iconString .= 'font-size:150%;';
447 $iconString .= '">⚠</span>'; // WARNING SIGN
449 elseif($protection_level=='normal') {
450 $iconString .= '<span style="color:#6666FF;';
451 if($size=='adjusted')
452 $iconString .= 'font-size:110%;';
453 $iconString .= '">ⓘ</span>'; // CIRCLED LATIN SMALL LETTER I
455 elseif($protection_level=='signature') {
456 $iconString .= '<span style="color:#33AAAA;';
457 if($size=='adjusted')
458 $iconString .= 'font-size:140%;';
459 $iconString .= '">✽</span>'; // HEAVY TEARDROP-SPOKED ASTERISK
461 elseif($protection_level=='signatureOrSystem') {
462 $iconString .= '<span style="color:#DD66DD;';
463 if($size=='adjusted')
464 $iconString .= 'font-size:140%;';
465 $iconString .= '">⚛</span>'; // ATOM SYMBOL
468 $iconString .= '<span style="color:#33AA33';
469 if($size=='adjusted')
470 $iconString .= ';font-size:130%;';
471 $iconString .= '">⚙</span>'; // GEAR
477 private function human_readable_size($size, $minDiv=0) {
478 $si_prefix = array('bytes','kB','MB');
481 for($i=0;(abs($size) > $div && $i < count($si_prefix)) || $i<$minDiv;$i++) {
485 return round($size,max(0,$i-1)).' '.$si_prefix[$i];
488 private function get_antifeature_description($antifeature) {
489 // Anti feature names and descriptions
490 $antifeatureDesctiption['ads']['name'] = 'Advertising';
491 $antifeatureDesctiption['ads']['description'] = 'This application contains advertising';
492 $antifeatureDesctiption['tracking']['name'] = 'Tracks You';
493 $antifeatureDesctiption['tracking']['description'] = 'This application tracks and reports your activity to somewhere';
494 $antifeatureDesctiption['nonfreenet']['name'] = 'Non-Free Network Services';
495 $antifeatureDesctiption['nonfreenet']['description'] = 'This application promotes a non-Free network service';
496 $antifeatureDesctiption['nonfreeadd']['name'] = 'Non-Free Addons';
497 $antifeatureDesctiption['nonfreeadd']['description'] = 'This application promotes non-Free add-ons';
498 $antifeatureDesctiption['nonfreedep']['name'] = 'Non-Free Dependencies';
499 $antifeatureDesctiption['nonfreedep']['description'] = 'This application depends on another non-Free application';
501 $antifeatureLower = strtolower($antifeature);
502 if(isset($antifeatureDesctiption[$antifeatureLower])) {
503 return $antifeatureDesctiption[$antifeatureLower];
505 return array('name'=>$antifeature);
509 function get_apps($query_vars) {
511 $xml = simplexml_load_file($this->site_path."/repo/index.xml");
512 $matches = $this->show_apps($xml,$query_vars,$numpages);
516 if(($query_vars['fdfilter']===null || $query_vars['fdfilter']!='') && $numpages>0)
518 $out.='<div style="float:left;">';
519 if($query_vars['fdfilter']===null) {
521 $categories = array('All categories');
522 $handle = fopen(getenv('DOCUMENT_ROOT').'/repo/categories.txt', 'r');
524 while (($buffer = fgets($handle, 4096)) !== false) {
525 $categories[] = rtrim($buffer);
530 $out.='<form name="categoryform" action="" method="get">';
531 $out.=$this->makeformdata($query_vars);
533 $out.='<select name="fdcategory" style="color:#333333;" onChange="document.categoryform.submit();">';
534 foreach($categories as $category) {
536 if(isset($query_vars['fdcategory']) && $category==$query_vars['fdcategory'])
538 $out.='>'.$category.'</option>';
542 $out.='</form>'."\n";
545 $out.='Applications matching "'.$query_vars['fdfilter'].'"';
549 $out.='<div style="float:right;">';
550 $out.='<a href="'.makelink($query_vars, array('fdstyle'=>'list','fdpage'=>'1')).'">List</a> | ';
551 $out.='<a href="'.makelink($query_vars, array('fdstyle'=>'grid','fdpage'=>'1')).'">Grid</a>';
554 $out.='<br break="all"/>';
562 $out.='<div style="width:20%; float:left; text-align:left;">';
563 $out.=' Page '.$query_vars['fdpage'].' of '.$numpages.' ';
566 $out.='<div style="width:60%; float:left; text-align:center;">';
568 for($i=1;$i<=$numpages;$i++) {
569 if($i == $query_vars['fdpage']) {
570 $out.='<b>'.$i.'</b>';
572 $out.='<a href="'.makelink($query_vars, array('fdpage'=>$i)).'">';
582 $out.='<div style="width:20%; float:left; text-align:right;">';
583 if($query_vars['fdpage']!=$numpages) {
584 $out.='<a href="'.makelink($query_vars, array('fdpage'=>($query_vars['fdpage']+1))).'">next></a> ';
589 } else if($query_vars['fdfilter']!='') {
590 $out.='<p>No matches</p>';
597 function makeformdata($query_vars) {
601 $out.='<input type="hidden" name="page_id" value="'.get_query_var('page_id').'">';
602 foreach($query_vars as $name => $value) {
603 if($value !== null && $name != 'fdfilter')
604 $out.='<input type="hidden" name="'.$name.'" value="'.$value.'">';
611 function show_apps($xml,$query_vars,&$numpages) {
617 if($query_vars['fdstyle']=='grid') {
618 $outputter = new FDOutGrid();
620 $outputter = new FDOutList();
625 $out.=$outputter->outputStart();
627 foreach($xml->children() as $app) {
629 if($app->getName() == 'repo') continue;
630 $appinfo['attrs']=$app->attributes();
631 $appinfo['id']=$appinfo['attrs']['id'];
632 foreach($app->children() as $el) {
633 switch($el->getName()) {
635 $appinfo['name']=$el;
638 $appinfo['icon']=$el;
641 $appinfo['summary']=$el;
644 $appinfo['description']=$el;
647 $appinfo['license']=$el;
650 $appinfo['category']=$el;
655 if(($query_vars['fdfilter']===null || $query_vars['fdfilter']!='' && (stristr($appinfo['name'],$query_vars['fdfilter']) || stristr($appinfo['summary'],$query_vars['fdfilter']) || stristr($appinfo['description'],$query_vars['fdfilter']))) && (!isset($query_vars['fdcategory']) || $query_vars['fdcategory'] && $query_vars['fdcategory']==$appinfo['category'])) {
656 if($skipped<($query_vars['fdpage']-1)*$outputter->perpage) {
658 } else if($got<$outputter->perpage) {
659 $out.=$outputter->outputEntry($query_vars, $appinfo);
667 $out.=$outputter->outputEnd();
669 $numpages = ceil((float)$total/$outputter->perpage);
675 // Class to output app entries in a detailed list format
680 function FDOutList() {
683 function outputStart() {
687 function outputEntry($query_vars, $appinfo) {
689 $out.='<hr style="clear:both;" />'."\n";
690 $out.='<a href="'.makelink($query_vars, array('fdid'=>$appinfo['id'])).'">';
691 $out.='<div id="appheader">';
693 $out.='<div style="float:left;padding-right:10px;"><img src="' . site_url() . '/repo/icons/'.$appinfo['icon'].'" style="width:48px;border:none;"></div>';
695 $out.='<div style="float:right;">';
696 $out.='<p>Details...</p>';
699 $out.='<p style="color:#000000;"><span style="font-size:20px;">'.$appinfo['name']."</span>";
700 $out.="<br>".$appinfo['summary']."</p>\n";
708 function outputEnd() {
713 // Class to output app entries in a compact grid format
720 function FDOutGrid() {
723 function outputStart() {
724 return "\n".'<table border="0" width="100%"><tr>'."\n";
727 function outputEntry($query_vars, $appinfo) {
728 $link=makelink($query_vars, array('fdid'=>$appinfo['id']));
732 if($this->itemCount%4 == 0 && $this->itemCount > 0)
734 $out.='</tr><tr>'."\n";
737 $out.='<td align="center" valign="top" style="background-color:#F8F8F8;">';
739 $out.='<div id="appheader" style="text-align:center;width:110px;">';
741 $out.='<a href="'.$link.'" style="border-bottom-style:none;">';
742 $out.='<img src="' . site_url() . '/repo/icons/'.$appinfo['icon'].'" style="width:48px;border-width:0;padding-top:5px;padding-bottom:5px;"><br/>';
743 $out.=$appinfo['name'].'<br/>';
754 function outputEnd() {
755 return '</tr></table>'."\n";
759 function permissions_cmp($a, $b) {
760 global $permissions_data;
762 $aProtectionLevel = $permissions_data['permission'][$a]['protectionLevel'];
763 $bProtectionLevel = $permissions_data['permission'][$b]['protectionLevel'];
765 if($aProtectionLevel != $bProtectionLevel) {
766 if(strlen($aProtectionLevel)==0) return 1;
767 if(strlen($bProtectionLevel)==0) return -1;
769 return strcmp($aProtectionLevel, $bProtectionLevel);
772 $aGroup = $permissions_data['permission'][$a]['permissionGroup'];
773 $bGroup = $permissions_data['permission'][$b]['permissionGroup'];
775 if($aGroup != $bGroup) {
776 return strcmp($aGroup, $bGroup);
779 return strcmp($a, $b);
782 // Make a link to this page, with the current query vars attached and desired params added/modified
783 function makelink($query_vars, $params=array()) {
784 $link=get_permalink();
785 $vars=linkify(array_merge($query_vars, $params));
788 if(strpos($link,'?')===false)
795 // Return the key value pairs in http-get-parameter format as a string
796 function linkify($vars) {
798 foreach($vars as $k => $v) {
799 if($k!==null && $v!==null && $v!='')
800 $retvar .= $k.'='.$v.'&';
802 return substr($retvar,0,-1);
805 function widget_fdroidlatest($args) {
808 echo $before_title . 'Latest Apps' . $after_title;
810 $handle = fopen(getenv('DOCUMENT_ROOT').'/repo/latestapps.dat', 'r');
812 while (($buffer = fgets($handle, 4096)) !== false) {
813 $app = explode("\t", $buffer);
814 echo '<a href="/repository/browse/?fdid='.$app[0].'">';
815 if(isset($app[2]) && trim($app[2])) {
816 echo '<img src="' . site_url() . '/repo/icons/'.$app[2].'" style="width:32px;border:none;float:right;" />';
818 echo $app[1].'<br />';
819 if(isset($app[3]) && trim($app[3])) {
820 echo '<span style="color:#BBBBBB;">'.$app[3].'</span>';
822 echo '</a><br style="clear:both;" />';
830 $wp_fdroid = new FDroid();