mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
367 lines
14 KiB
Markdown
367 lines
14 KiB
Markdown
# Application catalog
|
|
|
|
<span class="javascriptDisclaimer">
|
|
Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
|
|
<br/>
|
|
<br/>
|
|
</span>
|
|
|
|
<!--
|
|
Search bar
|
|
-->
|
|
<div class="input-group">
|
|
<span id="basic-addon1" class="input-group-addon" ><span class="glyphicon glyphicon-search"></span></span>
|
|
<input id="filter-app-cards" type="text" class="form-control" placeholder="Rechercher des apps..." aria-describedby="basic-addon1"/>
|
|
<div class="input-group-btn">
|
|
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
|
|
<span id="current-quality-filter" data-filter="decent">Seulement les apps de qualité décente</span> <span class="caret"></span>
|
|
</button>
|
|
|
|
<ul class="dropdown-menu">
|
|
<li><a href="#" data-quality-filter="high">Seulement les apps haute-qualité</a></li>
|
|
<li><a href="#" data-quality-filter="decent">Seulement les apps de qualité décente</a></li>
|
|
<li><a href="#" data-quality-filter="working">Seulement les apps fonctionelles</a></li>
|
|
<li><a href="#" data-quality-filter="none">Toutes les apps</a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<br />
|
|
|
|
<!--
|
|
Disclaimers
|
|
-->
|
|
|
|
<div class="alert alert-info">L'équipe de packaging d'applications sera heureuse de recevoir vos commentaires! Si vous trouvez des problèmes ou des améliorations possibles en installant une app, n'hésitez pas à contribuer en créant un ticket (issue) directement sur le dépôt de code.</div>
|
|
|
|
<div id="bad-quality-apps-disclaimer" class="alert alert-warning">
|
|
Les applications avec un niveau inférieur ou égal à 4 peuvent fonctionner, mais ne seront pas forcément bien intégrées avec YunoHost, ou bien ne respectent pas les bonnes pratiques de packaging.
|
|
</div>
|
|
|
|
<div id="broken-apps-disclaimer" class="alert alert-danger">
|
|
Les applications niveau 0, ou étiquettées <span class="label label-warning label-as-badge">inprogress</span>, <span class="label label-danger label-as-badge">notworking</span> sont toujours en cours de packaging ou sont connues pour être cassées. **Ne les installez pas** sur un serveur de production!
|
|
</div>
|
|
|
|
<div id="app-cards-list" class="app-cards-list"></div>
|
|
|
|
<div class="alert alert-warning">Si vous ne trouvez pas une application précise que vous recherchez, vous pouvez chercher un dépôt nommé nomdelapp_ynh sur Github ou internet, ou bien l'ajouter à la <a href="/apps_wishlist">liste d'apps souhaitées</a>.</div>
|
|
|
|
<!--
|
|
Custom CSS for this page
|
|
-->
|
|
|
|
<style>
|
|
/*=================================================
|
|
Search bar
|
|
=================================================*/
|
|
#filter-app-cards, #app-cards-list {
|
|
width:100%;
|
|
}
|
|
/*===============================================*/
|
|
|
|
/*=================================================
|
|
Force return space after card list
|
|
=================================================*/
|
|
#app-cards-list:after {
|
|
content:'';
|
|
display:block;
|
|
clear: both;
|
|
}
|
|
/*===============================================*/
|
|
|
|
/*=================================================
|
|
App card
|
|
=================================================*/
|
|
.app-card {
|
|
margin-bottom:20px;
|
|
width:270px;
|
|
float:left;
|
|
min-height: 1px;
|
|
margin-right: 10px;
|
|
margin-left: 10px;
|
|
border-radius: 3px;
|
|
}
|
|
/*===============================================*/
|
|
|
|
/*=================================================
|
|
App card body
|
|
=================================================*/
|
|
.app-card .panel-body > h3 {
|
|
margin-top:0;
|
|
margin-bottom:5px;
|
|
font-size:1.2em;
|
|
}
|
|
.app-card .app-badges {
|
|
height:35px;
|
|
}
|
|
.app-card .app-badges .label, .app-card-date-maintainer {
|
|
font-size:0.6em;
|
|
}
|
|
|
|
.label-epic {
|
|
background-color: darkorchid;
|
|
}
|
|
|
|
.app-card-date-maintainer {
|
|
text-align:right;
|
|
max-height: 18px;
|
|
margin-bottom: 3px;
|
|
margin-right: 7px;
|
|
margin-top: -5px;
|
|
}
|
|
|
|
.app-card .unmaintained {
|
|
color: #e0aa33;
|
|
}
|
|
|
|
.app-card-desc {
|
|
height:100px;
|
|
overflow: hidden;
|
|
}
|
|
/*===============================================*/
|
|
|
|
/*=================================================
|
|
App card footer
|
|
=================================================*/
|
|
.app-card .btn-group {
|
|
width:100%;
|
|
margin-left: 0px;
|
|
}
|
|
.app-card > .btn-group > .btn{
|
|
border-bottom:0;
|
|
font-size: 0.9em;
|
|
line-height: 1.58;
|
|
}
|
|
.app-card > .btn-group > .btn:first-child {
|
|
border-left:0;
|
|
border-top-left-radius:0;
|
|
}
|
|
.app-card > .btn-group > .btn:last-child {
|
|
border-right:0;
|
|
border-top-right-radius:0;
|
|
margin-left: 0px;
|
|
width: 33.6%;
|
|
}
|
|
/*===============================================*/
|
|
</style>
|
|
|
|
<!--
|
|
App card template
|
|
-->
|
|
|
|
<script type="text/template" id="app-template2">
|
|
<div class="app-card_{app_id} app-card panel panel-default" data-quality="{app_quality}">
|
|
|
|
<div class="panel-body">
|
|
<h3>{app_name}</h3>
|
|
<div class="app-badges"></div>
|
|
|
|
<div class="app-card-desc">{app_description}</div>
|
|
</div>
|
|
<div class="app-card-date-maintainer">
|
|
<span class="glyphicon glyphicon-refresh"></span> {app_update} -
|
|
<span title="{maintained_help}" class="{maintained_state}"><span class="glyphicon glyphicon-{maintained_icon}"></span> {app_maintainer}</span>
|
|
</div>
|
|
<div class="btn-group" role="group">
|
|
<a href="{app_git}" target="_BLANK" type="button" class="btn btn-default col-sm-4"><span class="glyphicon glyphicon-globe" aria-hidden="true"></span> Code</a>
|
|
<a href="#/app_{app_id}_en" target="_BLANK" type="button" class="btn btn-default col-sm-4"><span class="glyphicon glyphicon-book" aria-hidden="true"></span> Doc</a>
|
|
<a href="https://install-app.yunohost.org/?app={app_id}" target="_BLANK" type="button" class="btn btn-{app_install_css_style} col-sm-4 active"><span class="glyphicon glyphicon-plus" aria-hidden="true"></span> Installer</a>
|
|
</div>
|
|
|
|
</div>
|
|
</script>
|
|
|
|
<!--
|
|
Javascript helpers
|
|
-->
|
|
|
|
<script>
|
|
|
|
function timeConverter(UNIX_timestamp) {
|
|
var a = new Date(UNIX_timestamp*1000);
|
|
var months = ['January','February','March','April','May','June','July','August','September','October','November','December'];
|
|
var year = a.getFullYear();
|
|
var month = months[a.getMonth()];
|
|
var date = a.getDate();
|
|
var hour = a.getHours();
|
|
var min = a.getMinutes();
|
|
if (hour < 10) { hour = '0' + hour; }
|
|
if (min < 10) { min = '0' + min; }
|
|
var time = date+' '+month+' '+year;//+' at '+hour+':'+min
|
|
return time;
|
|
}
|
|
|
|
|
|
$(document).ready(function () {
|
|
|
|
// Hide warrant about states when we're using the default filter
|
|
$('#state-disclaimer').hide();
|
|
var quality_filters = "decent";
|
|
|
|
function filter(){
|
|
|
|
var current_quality_filter = $('#current-quality-filter').data("filter");
|
|
var user_input_in_search_field = $('#filter-app-cards').val().toLowerCase();
|
|
|
|
$('.app-card').each(function() {
|
|
// This is where we actually define how apps are filtered:
|
|
// we look for the name of the app (h3) and try to find the user input
|
|
// + we check this app match the current quality filter
|
|
var app_name = $(this).find('h3').text().toLowerCase();
|
|
if (app_name.indexOf(user_input_in_search_field) >= 0 && $(this).data("quality").indexOf(current_quality_filter) >= 0)
|
|
{
|
|
$(this).show();
|
|
}
|
|
else
|
|
{
|
|
$(this).hide();
|
|
}
|
|
});
|
|
|
|
// Display or hide the disclaimers depending on the current filter...
|
|
((current_quality_filter == "working") || (current_quality_filter == "none")) ? $("#bad-quality-apps-disclaimer").show() : $("#bad-quality-apps-disclaimer").hide();
|
|
((current_quality_filter == "none")) ? $("#broken-apps-disclaimer").show() : $("#broken-apps-disclaimer").hide();
|
|
}
|
|
|
|
//=================================================
|
|
// Search & filter bar event
|
|
//=================================================
|
|
$('#filter-app-cards').keyup(filter);
|
|
|
|
$('a[data-quality-filter]').on("click", function(){
|
|
$('#current-quality-filter').text($(this).text());
|
|
$('#current-quality-filter').data("filter", $(this).data("quality-filter"));
|
|
filter();
|
|
});
|
|
|
|
filter();
|
|
|
|
//=================================================
|
|
// Upload apps lists
|
|
//=================================================
|
|
var catalog = undefined;
|
|
|
|
// Fetch application catalog
|
|
|
|
$.getJSON('https://app.yunohost.org/apps.json', {}, function(data) {
|
|
|
|
catalog = $.map(data, function(el) { return el; });
|
|
|
|
// Clarify high quality state, and level if undefined or inprogress or notworking...
|
|
|
|
$.each(catalog, function(k, infos) {
|
|
if ((infos.level === undefined) || (infos.state === "inprogress") || (infos.state === "notworking")) {
|
|
infos.level = null;
|
|
}
|
|
if ((infos.high_quality === true) && (infos.level === 8)) {
|
|
infos.state = "high quality";
|
|
}
|
|
});
|
|
|
|
// Sort apps according to their state and level...
|
|
|
|
catalog.sort(function(a, b){
|
|
a_state = (a.state === "high quality")?4:(a.level > 4)?3:(a.state > 0)?2:1;
|
|
b_state = (b.state === "high quality")?4:(b.level > 4)?3:(b.state > 0)?2:1;
|
|
if (a_state < b_state || a_state == b_state && a.level < b.level || a_state == b_state && a.level == b.level && a.manifest.id > b.manifest.id) {return 1;}
|
|
else if (a.manifest.id == b.manifest.id) {return 0;}
|
|
return -1;
|
|
});
|
|
|
|
// Add the card for each app
|
|
|
|
$.each(catalog, function(k, infos) {
|
|
|
|
app_id = infos.manifest.id;
|
|
|
|
// Define what style to use for state, level and install button
|
|
// according to the app quality ....
|
|
|
|
if (infos.state === "high quality") {
|
|
app_quality = "high,decent,working,none";
|
|
app_state_css_style = "epic";
|
|
app_install_css_style = "success";
|
|
app_level_css_style = "epic";
|
|
} else if (infos.level > 4) {
|
|
app_quality = "decent,working,none";
|
|
app_state_css_style = "success";
|
|
app_install_css_style = "success";
|
|
app_level_css_style = "success";
|
|
} else if (infos.level > 0) {
|
|
app_quality = "working,none";
|
|
app_state_css_style = "success";
|
|
app_install_css_style = "warning";
|
|
app_level_css_style = "warning";
|
|
} else {
|
|
app_quality = "none";
|
|
if (infos.state === "working") {
|
|
app_state_css_style = "success";
|
|
}
|
|
else if (infos.state === "inprogress") {
|
|
app_state_css_style = "warning";
|
|
}
|
|
else {
|
|
app_state_css_style = "danger";
|
|
}
|
|
app_install_css_style = "danger";
|
|
app_level_css_style = "danger";
|
|
}
|
|
|
|
// If level is null, we wanna display '?'
|
|
if (infos.level == null) {
|
|
infos.level = '?';
|
|
}
|
|
|
|
// Fill the template
|
|
html = $('#app-template2').html()
|
|
.replace(/{app_id}/g, app_id)
|
|
.replace(/{app_name}/g, infos.manifest.name)
|
|
.replace('{app_description}', infos.manifest.description.fr)
|
|
.replace(/{app_git}/g, infos.git.url)
|
|
.replace('{app_branch}', infos.git.branch)
|
|
.replace('{app_level}', infos.level)
|
|
.replace('{app_quality}', app_quality)
|
|
.replace('{app_update}', timeConverter(infos.lastUpdate))
|
|
.replace('{app_state_css_style}', app_state_css_style)
|
|
.replace('{app_install_css_style}', app_install_css_style);
|
|
|
|
// Handle the maintainer info
|
|
if (infos.maintained == false)
|
|
{
|
|
html = html
|
|
.replace('{maintained_state}', 'unmaintained')
|
|
.replace('{maintained_icon}', 'warning-sign')
|
|
.replace('{app_maintainer}', "Unmaintained")
|
|
.replace('{maintained_help}', "This package is currently unmaintained. Feel free to propose yourself as the new maintainer !");
|
|
}
|
|
else {
|
|
html = html
|
|
.replace('{maintained_state}', 'maintained')
|
|
.replace('{maintained_icon}', 'user')
|
|
.replace('{maintained_help}', "Current maintainer of this package");
|
|
|
|
if ((infos.manifest.developer) && (infos.manifest.developer.name)) {
|
|
html = html.replace('{app_maintainer}', infos.manifest.developer.name);
|
|
}
|
|
else if ((infos.manifest.maintainer) && (infos.manifest.maintainer.name)) {
|
|
html = html.replace('{app_maintainer}', infos.manifest.maintainer.name);
|
|
}
|
|
else {
|
|
html = html.replace('{app_maintainer}', "???");
|
|
}
|
|
}
|
|
|
|
// Fill the template
|
|
$('#app-cards-list').append(html);
|
|
$('.app-card_'+ app_id).attr('id', 'app-card_'+ app_id);
|
|
$('.app-card_'+ app_id + ' .app-badges').append(' <span class="label label-'+app_state_css_style+' label-as-badge app-'+infos.state+'">'+infos.state+'</span>');
|
|
if ((infos.state === "high quality") || (infos.state === "working")) {
|
|
$('.app-card_'+ app_id + ' .app-badges').append(' <span class="label label-'+app_level_css_style+' label-as-badge">niveau '+infos.level+'</span>');
|
|
}
|
|
|
|
});
|
|
|
|
filter();
|
|
});
|
|
//=================================================
|
|
});
|
|
</script>
|